Borrowing it
Nothing to install: this file belongs to timwuhaotian/the-pair. 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/timwuhaotian/the-pair/main/AGENTS.mdgit clone --depth 1 https://github.com/timwuhaotian/the-pairWrote 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/timwuhaotian/the-pair/agents-md)<a href="https://agentmods.dev/instructions/timwuhaotian/the-pair/agents-md"><img src="https://agentmods.dev/badge/instructions/timwuhaotian/the-pair/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/timwuhaotian/the-pair/agents-md"><img src="https://agentmods.dev/badge/instructions/timwuhaotian/the-pair/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.04512 | $0.04512 |
| Opus 5.5 | $0.01805 | $0.01805 |
| Sonnet 5.5 | $0.00902 | $0.00902 |
| Haiku 4.5 | $0.00451 | $0.00451 |
Grade A, and why
the-pair AGENTS.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 16d 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.
- **If the tool can be installed** (pip, npm, brew, curl), install or update it in an isolated environment and run `--help` / `--json` sample invocations to examine the actual CLI surface and event output firsthand. This How it starts
The opening of the file, as written. The whole thing — 245 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AI Agent Guidelines for "The Pair"
This file contains instructions and context for any AI agents (like yourself) working on the the-pair repository.
Project Identity
"The Pair" is a Desktop application (v1.2.3) built with Tauri 2.x, React 19, and TypeScript. It orchestrates two local AI agents — a Mentor (planner/reviewer, read-only) and an Executor (code writer/command runner) — that cross-check each other's work. The app manages their lifecycle, monitors resources, tracks git changes, and provides a polished UI for humans to observe and intervene.
Tech Stack
- Framework: Tauri 2.0
- Backend: Rust
- Frontend: React 19, TypeScript
- Styling: Tailwind CSS v4,
clsx,tailwind-merge - Icons:
lucide-react - State Management:
zustand(usePairStore,useUpdateStore,useThemeStore) - Animations: Framer Motion
Architecture Rules
- Rust Backend vs. React Frontend:
- Never import Node.js built-ins directly into the Renderer (
src/renderer/src/). - Use Tauri commands in
src-tauri/src/to expose strict APIs to the frontend. - Frontend calls backend via
invoke()from@tauri-apps/api/core.
- Never import Node.js built-ins directly into the Renderer (
- Styling:
- Always use Tailwind CSS classes. Custom dark/light mode palette is defined in
src/renderer/src/assets/main.css. - Shell chrome (sidebar, hub, inspector, modals, palette) uses sans (
font-sans, Geist Sans/SF); the conversation core (pair stream, diffs, code) uses mono (font-mono, Geist Mono). Never re-mono shell labels or re-sans the stream —tests/shellTypography.test.tspins the split. - Shell surfaces use
.shell-card(+.shell-card-hover); the sidebar rail uses.app-source-list. The stream stays flat with hairline borders. - Use the
cn()utility fromsrc/renderer/src/lib/utils.tsfor conditional class merging.
- Always use Tailwind CSS classes. Custom dark/light mode palette is defined in
- Agent Interactions:
- The application spawns processes. Always implement an iteration limit (
maxIterations) before pausing for human intervention. - Use the handoff guard (
src/renderer/src/lib/handoffGuard.ts) to prevent race conditions when pairs finish.
- The application spawns processes. Always implement an iteration limit (
- Error Handling:
- Handle permissions and locked files defensively in the Rust backend.
- Propagate errors cleanly to the frontend via Tauri commands to display in the
ErrorDetailPanel.
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.
- 16d ago Changed · +11 lines · +359 tokens per session 7f60c0b71b6f
- 21d ago Changed · +2 lines · +82 tokens per session 4ec273994791
- 1mo ago Changed · +25 lines · +690 tokens per session 54264a4c0177
- 1mo ago Changed · +182 tokens per session 7f017f051906
- 1mo ago Changed · +41 tokens per session c73a1c76afdd
- 1mo ago Changed · +2 lines · +68 tokens per session 119669843983
- 1mo ago First seen · 205 lines · 3,090 tokens per session scan A 1e5392d2c754
the-pair AGENTS.md is an instructions file published in the GitHub repository timwuhaotian/the-pair (384 stars, last pushed 5d ago), licensed Apache-2.0. It adds 4,512 tokens to every session, about $0.0180 per session on Opus 5.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-30.
Other instructions, from other repositories
vibe-coding-prompt-template backend.instructions.md
Instructions for KhazP/vibe-coding-prompt-template: Read AGENTS.md, agentdocs/techstack.md, and agentdocs/codepatterns.md.
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode copilot-instructions.md
Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).