pi-subagents is a pi extension that runs specialized AI sub-agents in separate sessions and coordinates them through parallel or sequential workflows. It is for developers who want autonomous agents with independent tools, prompts, models, and controllable execution. The catalogue agents and instruction define additional agent types and orchestration workflows for pi.
Borrowing it
Nothing to install: this file belongs to tintinweb/pi-subagents. 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/tintinweb/pi-subagents/master/AGENTS.mdgit clone --depth 1 https://github.com/tintinweb/pi-subagentsWrote 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/tintinweb/pi-subagents/agents-md)<a href="https://agentmods.dev/instructions/tintinweb/pi-subagents/agents-md"><img src="https://agentmods.dev/badge/instructions/tintinweb/pi-subagents/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/tintinweb/pi-subagents/agents-md"><img src="https://agentmods.dev/badge/instructions/tintinweb/pi-subagents/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.02969 | $0.02969 |
| Opus 5.5 | $0.01188 | $0.01188 |
| Sonnet 5.5 | $0.00594 | $0.00594 |
| Haiku 4.5 | $0.00297 | $0.00297 |
Grade A, and why
pi-subagents 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 4d 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.
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 — 166 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Development Rules
Conversational Style
- Keep answers short and concise
- No emojis in issues, PR comments, or code
- No fluff or cheerful filler text (e.g., "Thanks @user" not "Thanks so much @user!")
- Technical prose only, be direct
- When the user asks a question, answer it first before making edits or running implementation commands.
- When responding to user feedback or an analysis, explicitly say whether you agree or disagree before saying what you changed.
Code Quality
- Read files in full before wide-ranging changes, before editing files you have not fully inspected, and when asked to investigate or audit. Do not rely on search snippets for broad changes.
- No
anyunless absolutely necessary. - Inline single-line helpers that have only one call site.
- Check
node_modulesfor external API types (@earendil-works/pi-*,typebox, etc.); don't guess. - No inline imports (
await import(),import("pkg").Type, dynamic type imports). Top-level imports only. - Never remove or downgrade code to fix type errors from outdated deps; upgrade the dep instead.
- Match the surrounding code style — it is enforced by biome (
biome.json). - Always ask before removing functionality or code that appears intentional.
- Do not preserve backward compatibility unless the user asks for it.
- This is a pi extension. Respect the Claude Code-compatible tool names, calling conventions, and UI patterns the extension deliberately mirrors; don't diverge from them without a stated reason.
Reviewing
Applies to every review: an external PR, your own branch, or the working tree.
- Report correctness defects first: wrong behavior, crashes, races, data loss, broken contracts, missing or wrong tests for changed behavior, docs or comments that now contradict the code. State each with the input or state that triggers it.
- Also flag overengineering: needless abstraction, layering, or defensive code the change doesn't warrant. Favor the elegant solution.
- No nits: style, naming, formatting, comment wording, or other preferences. Violations of this file's rules are findings, except code style that biome accepts.
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.
- 4d ago Changed · +8 lines · +148 tokens per session 63333001f024
- 24d ago Changed · +1 lines · +93 tokens per session 12385410caf0
- 25d ago Changed · +2 lines · +35 tokens per session d33f783bbfbb
- 28d ago Changed · -3 tokens per session 19e6f851d22e
- 2mo ago First seen · 155 lines · 2,696 tokens per session scan A 153f8dd763d0
pi-subagents AGENTS.md is an instructions file published in the GitHub repository tintinweb/pi-subagents (1,407 stars, last pushed 2d ago), licensed MIT. It adds 2,969 tokens to every session, about $0.0119 per session on Opus 5.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-08-30.
pi-subagents AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| pi-subagents AGENTS.mdtintinweb/pi-subagents | Instructions file | 1.4k | 2d ago | MIT | A | 2,969 | 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 |