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.
npx agentmods add instructions/msradam/semley/agents-mdgit clone --depth 1 https://github.com/msradam/semleyWhat 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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.01044 | $0.01044 |
| Opus 5 | $0.00522 | $0.00522 |
| Sonnet 5 | $0.00209 | $0.00209 |
| Haiku 4.5 | $0.00104 | $0.00104 |
Grade A, and why
semley AGENTS.md scanned grade A with 0 findings 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 yesterday.
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.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 93 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
Guidance for coding agents (and people) working in this repo. Semley is an autonomous
SRE investigation agent: a language model drives an investigation through one governed
step tool, a Burr state machine gates which transitions are legal, and conclusions are
verified against real evidence in code the model cannot reach. README.md has the full
design; this file is the fast path to running it.
Setup
uv sync # needs uv and Python 3.12+
printf 'OPENAI_API_KEY=sk-...\n' > .env # any OpenAI-compatible key; default model gpt-5.4
The agent is vendor-agnostic (it speaks the OpenAI chat-completions protocol). For a
non-OpenAI vendor, also set OPENAI_BASE_URL (e.g. https://openrouter.ai/api/v1) and
SEMLEY_MODEL (e.g. anthropic/claude-sonnet-5).
Verify it works (no key, no infrastructure)
make check # 7 fast deterministic tests; no model, no infra
To see a real end-to-end investigation without a key or any infrastructure, read
recordings/host-investigation.txt.
Run the agent
uv run semley --surface host # needs a key; the host demo also needs OrbStack
Describe an incident in plain language, confirm the proposed target and scope, and it
drives the investigation to a grounded conclusion. /playbook saves the recorded
Ansible reads as a standard playbook, /quit exits, Tab completes the commands.
Demo targets
Each command below stands up its own target (printing clear status) and then runs the agent. These create real local infrastructure, so run them deliberately, not as a quick check:
| Command | What it does | Requires |
|---|---|---|
make demo-host |
inject a service fault on web1, investigate, restore |
OrbStack |
make demo-cluster |
kind cluster + a workload in ImagePullBackOff, investigate | Docker, kind, kubectl |
make demo-telemetry |
Prometheus + a down scrape target, investigate | Docker, kind, kubectl |
make demo-localhost |
investigate this machine | nothing extra |
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.
- yesterday First seen · 93 lines · 1,044 tokens per session scan A 073441b81945
semley AGENTS.md is an instructions file published in the GitHub repository msradam/semley (0 stars, last pushed 1mo ago), licensed MIT. It adds 1,044 tokens to every session, about $0.0052 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-01.
Other instructions, from other repositories
home-ops AGENTS.md
AGENTS.md instructions for gavinmcfall/home-ops, covering ai assistant configuration, 📚 documentation location, 📖 read first, ⚠️ critical invariants and capsule: gitopsreconciliation.
home-ops copilot-instructions.md
Instructions for GitHub Copilot when working with this homelab repository.
home-ops AGENTS.md
Instructions for edgard/home-ops, covering home ops, build & test, developer loop, project layout and conventions.
sentry-selfhosted-mcp AGENTS.md
Instructions for HieuAnh87/sentry-selfhosted-mcp, covering selfhosted-sentry-mcp, commands, install deps, build typescript to ./build and set executable bit and watch mode during source edits.
sentry-selfhosted-mcp CLAUDE.md
Instructions for HieuAnh87/sentry-selfhosted-mcp, covering selfhosted-sentry-mcp — claude code overrides, claude-specific and quick reminders.
cybermem GEMINI.md
Gemini CLI instructions for mikhailkogan17/cybermem, covering cybermem - gemini.md, 1. cybermem project overview, landing and documentation, 1.2 agile roles & responsibilities and 1.3 sprint lifecycle (tokens optimization).