Borrowing it
Nothing to install: this file belongs to alexarthurs/herdr-sidebar. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/alexarthurs/herdr-sidebar/main/AGENTS.mdgit clone --depth 1 https://github.com/alexarthurs/herdr-sidebarWrote 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.
[](https://agentmods.dev/instructions/alexarthurs/herdr-sidebar/agents-md)<a href="https://agentmods.dev/instructions/alexarthurs/herdr-sidebar/agents-md"><img src="https://agentmods.dev/badge/instructions/alexarthurs/herdr-sidebar/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/alexarthurs/herdr-sidebar/agents-md"><img src="https://agentmods.dev/badge/instructions/alexarthurs/herdr-sidebar/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.27324 | $0.27324 |
| Opus 5.5 | $0.10930 | $0.10930 |
| Sonnet 5.5 | $0.05465 | $0.05465 |
| Haiku 4.5 | $0.02732 | $0.02732 |
Grade C, and why
herdr-sidebar AGENTS.md scanned grade C with 2 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 28d 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.
Downloads and executes remote codehighSupply chain
curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.
- Install: `curl -fsSL https://herdr.dev/install.sh | sh` (lands in `~/.local/bin`), then Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
releases on a background thread (bounded curl request, 30-minute cache); local/third-party How it starts
The opening of the file, as written. The whole thing — 1,421 lines — stays where its author put it; the contents beside it link to each section on GitHub.
herdr-sidebar monorepo
This file is a living doc — always capture findings. Whenever you discover something non-obvious the hard way (a herdr behavior, a Windows quirk, a manifest gotcha, a build issue), record it here in the relevant section before finishing the task, the way the Windows caveats below were captured. If you're working in a feature worktree, commit the AGENTS.md update on your branch so it lands on main with the merge.
One herdr plugin, a VS Code-style sidebar for the terminal, as a self-contained Rust crate:
plugins/herdr-sidebar— file explorer + source control in ONE binary (ratatui TUI). Unified mode shows both views in a single "Sidebar" pane with an activity-bar switcher (in-process, instant); the ⚙ settings can split them into separate Explorer / Source Control panes (--view explorer|gitpins a pane's starting view).--previewruns the file-preview pane. Views live insrc/explorer_app.rs/src/scm_app.rs(bin modules); shared pieces (icons, ipc, launch parsing, state, ui helpers, git plumbing +gitdecodecorations) are lib modules — nothing is copy-mirrored anymore.
There is deliberately no root cargo workspace: herdr plugin install <owner>/<repo>/<subdir>
treats the subdirectory as the plugin root, and each plugin's herdr-plugin.toml points at
./target/release/<bin> — a shared workspace would hoist target/ to the repo root and break
that path. Keep every crate buildable standalone from its own directory.
Build / test / lint
Run from inside the plugin directory, not the repo root:
cd plugins/herdr-sidebar
cargo build --release
cargo test
cargo clippy -- -D warnings
CI uses the LATEST stable toolchain (dtolnay/rust-toolchain@stable), so a stale local
stable can pass clippy while CI fails on a newly deprecated API (v0.15.1: fetch_update →
try_update, which is also newer than our rust-version = 1.89 MSRV — rewrite instead of
renaming). Run rustup update stable (or cargo +<latest> clippy) before tagging a release.
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.
- 28d ago Changed · +70 lines · +1,572 tokens per session 8e3fe02c8812
- 1mo ago Changed · +120 lines · +2,165 tokens per session 6faa1a92cd6d
- 1mo ago First seen · 1,231 lines · 23,587 tokens per session scan C f05edaf40999
herdr-sidebar AGENTS.md is an instructions file published in the GitHub repository alexarthurs/herdr-sidebar (538 stars, last pushed 6d ago), licensed MIT. It adds 27,324 tokens to every session, about $0.1093 per session on Opus 5.5. A static security scan graded it C with 2 findings (downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-27.
herdr-sidebar AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| herdr-sidebar AGENTS.mdalexarthurs/herdr-sidebar | Instructions file | 538 | 6d ago | MIT | C | 27,324 | Codex, OpenCode |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | today | MIT | A | 7,461 | Codex, OpenCode |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | yesterday | MIT | A | 4,680 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 5,516 | GitHub Copilot |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 274k | 2d ago | MIT | A | 4,313 | Codex, OpenCode |