Home

agent-notes

AI agent configuration manager for Claude Code and OpenCode. Orchestrates a team of specialized subagents across three model tiers — Opus reasons, Sonnet executes, Haiku explores.

Quick Start (macOS)

# install pipx if you don't have it
brew install pipx
pipx ensurepath

# install agent-notes
pipx install agent-notes

# set up agents, skills, rules, and memory
agent-notes install

# verify everything is wired up
agent-notes doctor

Key Features

• Specialized AI subagents with role-based model tiers
• On-demand skills (TDD, Docker, Git, Rails, debugging, refactoring)
• Multiple memory storage options (Local, Obsidian, Wiki) with per-project scoping
• Global rules and guardrails (safety, code quality)
• Multi-CLI support (Claude Code, OpenCode, GitHub Copilot)
• Session cost reporting with per-agent breakdown
• Interactive installation wizard with tab completion

Philosophy

You are the lead. The agents are your team. Plan, delegate, verify. The lead orchestrates — it doesn't write code, grep files, or run builds. Specialized agents do the work at the right model tier and cost.

Wiki Pages

• How-To — Practical guide to each memory mode, Karpathy wiki, Pocock sessions, recipes
• Workflow — Session phases, task pipelines, delegation, review, verification
• Commands — Complete CLI reference (every command, every flag)
• AI-CLIs — Supported AI coding assistants
• Agents — All specialized subagents and delegation rules
• Skills — On-demand workflow skills
• Models — Model tiers, roles, and configuration
• Memory-Storage — Local, Obsidian, and Wiki storage modes
• Cost-Report — Session cost tracking and analysis
• Inspirations — Credits and inspirations (Karpathy, Pocock)