CLI

TokRepo for Aider

Aider is a terminal pair-programmer. CONVENTIONS.md is read on every session start.

60-second integration

Shortest path for Aider

01
npx -y tokrepo@latest init-agent --target aider
02
Aider auto-loads CONVENTIONS.md from the repo root.
03
For MCP-via-stdio bridge, use the Aider plugin or run tokrepo CLI from chat: /run tokrepo agent-check "<task>" --json

Project rule file

CONVENTIONS.md

Install surface

CONVENTIONS.md

MCP client

CLI fallback (no native MCP yet)

MCP install command

/run npx -y tokrepo@latest session-init --json

Six mandatory rules

SESSION BOOTSTRAP — call tokrepo_session_init once per session.
DISCOVER BEFORE BUILD — call tokrepo_discover before writing reusable artifacts.
VERIFY BEFORE INSTALL — install_plan must include trust_gate; honor TOKREPO_MIN_TRUST (default 0.6).
DRY-RUN BEFORE APPLY — lifecycle tools default dry_run=true.
HANDOFF AFTER REUSABLE WORK — call tokrepo_handoff_plan.
PRIVATE BY DEFAULT, NEVER PUSH SECRETS.