agent-notes
AI agent configuration manager for Claude Code and OpenCode.
Configures a Lead agent (Opus) that orchestrates a team of 18 specialized subagents across three model tiers — so Opus plans and reasons, Sonnet executes, and Haiku explores.
Quick Start
git clone https://github.com/rubakas/agent-notes.git ~/agent-notes
ln -sf ~/agent-notes/bin/agent-notes /usr/local/bin/agent-notes
agent-notes install # interactive wizard guides you through setup
agent-notes doctor
Update anytime with agent-notes update (pulls latest, shows diff, reinstalls).
What's Included
| Component | Description |
|---|
| Skills | 35 on-demand knowledge modules (Rails, Docker, Git, Kamal, Process) |
| Agents | 18 specialized AI subagents with hierarchical model strategy |
| Rules | Global instructions, code quality, and safety guardrails |
| Config | Global instructions for Claude Code, OpenCode, and GitHub Copilot |
CLI Reference
agent-notes <command> [options]
| Command | Description |
|---|
install [--local] [--copy] | Interactive wizard or direct install |
uninstall [--local] | Remove installed components |
update | Pull latest, rebuild, reinstall |
doctor [--local] [--fix] | Check installation health |
info | Show status and component counts |
list [clis|models|roles|agents|skills|rules|all] | List engine components or installed |
set role <role> <model> [--cli <cli>] | Change model for a role (Phase 10+) |
regenerate [--cli <cli>] | Rebuild files from state.json (Phase 10+) |
validate | Lint source configuration files |
memory [list|size|show|reset|export|import] [name] | Manage agent memory |
Supported platforms
| Platform | Install target | Config format |
|---|
| Claude Code | ~/.claude/ | YAML frontmatter + Markdown prompts |
| OpenCode | ~/.config/opencode/ | YAML frontmatter + Markdown prompts |
| GitHub Copilot | ~/.github/ | copilot-instructions.md |
Examples
# Interactive install (recommended)
agent-notes install
# Example wizard session:
#
# Which CLI do you use?
# 1) [*] Claude Code
# 2) [*] OpenCode
# Enter numbers to toggle (comma-separated), or press enter for defaults.
# Choice: ← press enter to keep both
#
# Step 2/7: Configure model roles
# Which models should each role use? (claude)
#
# orchestrator [claude-opus-4-7] Plans, delegates, synthesizes
# reasoner [claude-opus-4-7] Complex reasoning, architecture
# worker [claude-sonnet-4-6] Implements, writes, edits
# scout [claude-haiku-4-5] Fast search and exploration
#
# Enter role=model pairs to change, or press enter to keep defaults.
# Choice: ← press enter to keep defaults
#
# Where to install?
# 1) * Global (~/.claude, ~/.config/opencode)
# 2) Local (current project)
# Choice [1]: ← press enter for global
#
# How to install?
# 1) * Symlink (auto-updates when source changes)
# 2) Copy (standalone, allows local customization)
# Choice [1]: ← press enter for symlink
#
# Which skills to include?
# 1) [*] Rails — models, controllers, views, routes, testing (24 skills)
# 2) [*] Docker — Dockerfile, Compose patterns (4 skills)
# 3) [*] Kamal — deployment with Kamal (1 skill)
# 4) [*] Git — commit workflow, conventional commits (1 skill)
# 5) [*] Process — TDD, refactoring, debugging, planning (5 skills)
# Choice: ← press enter for all
#
# Ready to install:
# CLI: Claude Code + OpenCode
# Scope: Global (~/.claude, ~/.config/opencode)
# Mode: Symlink
# Skills: Rails (24), Docker (4), Kamal (1), Git (1), Process (5)
# Agents: 18 (Claude Code) + 19 (OpenCode)
# Config: CLAUDE.md, AGENTS.md
# Rules: 2
# Proceed? [Y/n]: Y
# Direct install (scripted, no wizard)
agent-notes install --local
agent-notes install --local --copy
# Check health and fix issues
agent-notes doctor --fix
# Manage agent memory
agent-notes memory list
agent-notes memory vault # show current backend and path
agent-notes memory index # regenerate Index.md
agent-notes memory add "Rails enum prefix" \
"Always use _prefix: true to avoid method name collisions" \
pattern coder
Agent Team
Specialized subagents with hierarchical model strategy: Opus 4.7 decides, Sonnet 4 executes, Haiku 4.5 explores.
Agent roster