agentmods.dev

simple-host CLAUDE.md

simple-host CLAUDE.md is an instructions file for coding agents from vineetu/simple-host. It costs 2,078 tokens per session, scanned A, original, MIT.

Repository instructions for AI coding assistants working on simple-host, a Go program that hosts static websites and provides an API, admin interface, and database-backed features.

In plain words
What is it for?
Use them when modifying simple-host so requests are routed correctly and changes fit the existing design.
Why use it?
They give an assistant the project's layout, architecture, conventions, and important implementation details before it changes code.

Instructions file

not rated 1 3d ago A scan 2,078 tokens original MIT
View the source file vineetu/simple-host
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/vineetu/simple-host/claude-md
Clone the repo
git clone --depth 1 https://github.com/vineetu/simple-host

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for simple-host CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/vineetu/simple-host/claude-md.svg)](https://agentmods.dev/instructions/vineetu/simple-host/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/vineetu/simple-host/claude-md"><img src="https://agentmods.dev/badge/instructions/vineetu/simple-host/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 2,078 This file is loaded in full into every session.
When invoked 2,078 The same file — it is already loaded in full.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.02078 $0.02078
Opus 5 $0.01039 $0.01039
Sonnet 5 $0.00416 $0.00416
Haiku 4.5 $0.00208 $0.00208

Measured 3d ago against content hash da18d6f16d2f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

simple-host CLAUDE.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- `/v1/sites/{site}/state` — per-site JSON state. **Public-read scratch storage**: GETs are Origin/Referer-gated (a real browser can't forge that cross-site; `curl` can). Writes (`PUT`/`PATCH` state, `POST` collections)
CLAUDE.md · 101 lines

How it starts

The opening of the file, as written. The whole thing — 101 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

This file gives agents (Claude Code, Codex CLI, Cursor, etc.) the context they need to work in this repo. The user-facing overview is in README.md; this file is the agent crib sheet — architecture, conventions, gotchas.

What this is

One Go binary that hosts static websites. Users register, upload tarballs via API, files are extracted to a versioned directory tree on disk. The same binary serves the API, the static sites, the admin browser UI, and the bundled Website Deploy plugin (as /skills.zip, /plugin.zip, /install.sh).

There is no separate object store, CDN, build pipeline, or microservices. Everything is cmd/server/main.go plus a data directory plus a Postgres.

Live instance: https://simple-host.app

Layout

  • cmd/server/main.go — wires config, opens Postgres, creates DiskStorage, mounts every handler onto a single http.ServeMux, runs the HTTP server with graceful shutdown. All routing decisions live here.
  • internal/config — env-driven config. DB_DSN and ADMIN_API_KEY are required; everything else has a sensible default.
  • internal/auth — X-API-Key middleware. The hardcoded ADMIN_API_KEY short-circuits to a synthetic admin user with ID="admin"; everything else looks up the users table. Middleware reads only X-API-Key — never the site session cookie. A hosted-page Google/GitHub sign-in is the same users row (oauth_identities); the __Host-sh_vsess cookie is accepted only by visitorWriteOK for state/collections writes.
  • internal/db — raw database/sql against Postgres. Schema is in db/schema.sql (no migrations framework).
  • internal/storage/disk.go — versioned site layout on disk: <DATA_DIR>/<site>/v<n>/ with a current directory holding the live version.
  • internal/tarball — extracts and validates uploaded archives (path traversal guards, size limits, extension denylist for source-script types only).
  • internal/handler/*.go — one file per feature area. Treat them as separate apps that happen to share a *sql.DB and the same mux.
  • internal/handler/static/ — embedded HTML/CSS/fonts for the landing page, admin UI, docs page, OpenAPI spec.
  • internal/handler/notice_middleware.go — wraps responses on agent-facing routes with a _notice field when the caller's X-Skill-Version header is missing or stale. NOT applied to state endpoints, static serving, or skill downloads.
  • simple-host-website/ — the Website Deploy plugin. Embedded into the Go binary via embed.go so /skills.zip, /plugin.zip, /install.sh work out of the box.

Read the full file on GitHub · 101 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 101 lines · 2,078 tokens per session scan A da18d6f16d2f

Subscribe to this mod's changes

simple-host CLAUDE.md is an instructions file published in the GitHub repository vineetu/simple-host (1 stars, last pushed 3d ago), licensed MIT. It adds 2,078 tokens to every session, about $0.0104 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

agent-skillsclaude-codeclaude-code-pluginclaude-pluginclaude-skillmcp
Related

Other instructions, from other repositories

create-claude-plugin CLAUDE.md

Claude Code instructions for codyhxyz/create-claude-plugin, covering create-claude-plugin — claude code plugin, canonical design docs — read first, directory invariants, two-layer validation architecture and path rules.

codyhxyz/create-claude-plugin · 958 tokens

heimdall AGENTS.md

Instructions for randomittin/heimdall, covering working in the heimdall repo, the rules that actually block you, environment, conventions and heimdall — this repo is gated.

randomittin/heimdall · 1,020 tokens

genesis-architect CLAUDE.md

Claude Code instructions for maioio/genesis-architect, covering genesis architect - claude code instructions, project structure, how this skill works, development workflow and key constraints (enforced in skill.md).

maioio/genesis-architect · 582 tokens

Fireteam AGENTS.md

Instructions for martinnaithani/Fireteam, covering agent instructions for maintaining fireteam, what this repo is, critical constraints, file structure and naming conventions (do not change).

martinnaithani/Fireteam · 1,156 tokens

omg-payment-skill GEMINI.md

Gemini CLI instructions for chenmitchell/omg-payment-skill, covering google gemini 使用指引, 適用版本, 載入方式, gemini web / app and gemini cli.

chenmitchell/omg-payment-skill · 1,843 tokens

pinescript-plugin AGENTS.md

AGENTS.md instructions for jpantsjoha/pinescript-plugin, covering agents.md — pinescript-plugin (codex always-on adapter) and contract.

jpantsjoha/pinescript-plugin · 278 tokens