Persistent memory, code intelligence, and multi-agent orchestration for AI coding assistants. Works with Claude Code, OpenCode, and Codex CLI.
Prerequisite: Bun — the only runtime dependency. The Go binary downloads automatically.
Claude Code:
claude plugin marketplace add jmylchreest/aide
claude plugin install aide@aideOpenCode:
bunx @jmylchreest/aide-plugin installCodex CLI:
bunx @jmylchreest/aide-plugin install --platform codexThe Go binary downloads automatically on first run. Skills become available immediately.
| Capability | What it does |
|---|---|
| Memory | Remembers preferences and context across sessions |
| Decisions | Records architectural choices, enforces them in every session |
| Blueprints | Seeds best-practice decisions for Go, Rust, GitHub Actions, and more |
| Code Index | Fast symbol search, call graphs, and references via tree-sitter |
| Static Analysis | Detects complexity, coupling, secrets, and code duplication |
| Survey | Maps codebase structure: modules, entry points, tech stack, churn hotspots |
| Skills | 23 built-in workflows triggered by natural language |
| Swarm | Parallel agents with full SDLC pipelines (design, test, implement, verify, docs) |
| 34 MCP Tools | Full programmatic access to all capabilities above |
Survey this codebase and help me understand its structure.
AIDE indexes symbols, discovers modules, tech stack, entry points, and git churn hotspots, then presents the big picture. Full guide
Bootstrap with curated best practices, then customise:
aide blueprint import go go-github-actions # seeds decisions from blueprints
aide blueprint import --detect # or auto-detect from project markersThen refine with the decide skill for project-specific choices:
Help me decide on the auth strategy and database schema for this project.
Blueprints cover language idioms, tooling, CI/CD, and common pitfalls. The decide skill handles project-specific architectural choices. Both persist across every future session. Full guide
Export decisions and memories to git-friendly markdown, then commit them:
aide share export # writes to .aide/shared/
git add .aide/shared && git commit -m "share: team decisions"Teammates who add AIDE_SHARE_AUTO_IMPORT=1 to .claude/settings.json get them imported automatically at session start. Decisions are append-only per topic (new ones supersede, history kept); memories merge by ULID (newer edits win).
Teammates without AIDE can still use the folder. Each .aide/shared/decisions/*.md and .aide/shared/memories/*.md is self-contained markdown with structured frontmatter — any AI assistant can ingest them as context. A short DECISIONS.md / MEMORIES.md explainer is written alongside the exports to document the format. Full guide
Skills are markdown workflows triggered by keywords. Type naturally — trigger matching is fuzzy.
| Skill | Example Prompt | What Happens |
|---|---|---|
| swarm | swarm 3 implement dashboard |
Parallel agents with SDLC pipeline per story |
| plan-swarm | plan swarm for the dashboard |
Decomposes work into stories for swarm execution |
| decide | help me decide on auth strategy |
Structured decision interview, records choices |
| design | design the auth system |
Technical spec with interfaces and acceptance criteria |
| survey | survey this codebase |
Maps modules, tech stack, entry points, and churn |
| test | write tests for auth |
Test suite with coverage verification |
| implement | implement the feature |
TDD — make failing tests pass |
| verify | verify the implementation |
Full QA: tests, lint, types, build, debug artifacts |
| docs | update the documentation |
Updates docs to match implementation |
| autopilot | autopilot fix all failing tests |
Persistent — won't stop until verified complete |
| build-fix | fix the build errors |
Iteratively fixes build/lint/type errors |
| debug | debug why login fails |
Systematic debugging with hypothesis testing |
| perf | optimize the API |
Performance profiling and optimization |
| review | review this PR |
Security-focused code review |
| patterns | check code health |
Surface code quality issues via static analysis |
| assess-findings | assess findings |
Triage: read code, accept noise, keep real issues |
| code-search | find all auth functions |
Search symbols, find call sites |
| memorise | remember I prefer vitest |
Stores info for future sessions |
| recall | do you remember the testing decision? |
Searches memories and decisions |
| forget | forget the old auth decision |
Soft-delete or hard-delete memories |
| git | create a worktree for this feature |
Git operations and worktree management |
| worktree-resolve | merge worktrees |
Merges worktree branches with conflict resolution |
| context-usage | how much context am I using? |
Analyze session context and token usage |
Custom skills: Create .aide/skills/my-skill.md with YAML frontmatter (name, triggers) and markdown body. Auto-discovered from .aide/skills/ > skills/ > plugin-bundled > ~/.aide/skills/.
| Variable | Description |
|---|---|
AIDE_DEBUG=1 |
Enable debug logging (logs to .aide/_logs/) |
AIDE_FORCE_INIT=1 |
Force initialization in non-git directories |
AIDE_CODE_WATCH=1 |
Enable file watching for auto-reindex |
AIDE_CODE_WATCH_DELAY=30s |
Delay before re-indexing after file changes |
AIDE_MEMORY_INJECT=0 |
Disable memory injection |
AIDE_MEMORY_SCORING_DISABLED=1 |
Disable memory scoring (use chronological order) |
AIDE_MEMORY_DECAY_DISABLED=1 |
Disable recency decay in memory scoring |
AIDE_SHARE_AUTO_IMPORT=1 |
Auto-import shared decisions/memories on start |
aide status # System dashboard
aide code index # Index codebase symbols
aide code search "getUser" # Search symbols
aide survey run # Map codebase structure
aide findings run all # Run all static analysers
aide findings stats # Health overview
aide findings list --severity=critical # View critical findings
aide version # Check binary versionOptional web dashboard for monitoring aide daemon instances — status, memories, decisions, findings, code search, and more.
Download: Latest release
| Platform | Binary |
|---|---|
| Linux x64 | aide-web-linux-amd64 |
| Linux arm64 | aide-web-linux-arm64 |
| macOS x64 | aide-web-darwin-amd64 |
| macOS arm64 | aide-web-darwin-arm64 |
| Windows x64 | aide-web-windows-amd64.exe |
| Windows arm64 | aide-web-windows-arm64.exe |
aide-web --port 8080 --openFull documentation: jmylchreest.github.io/aide
- Architecture — Layered design, hooks, MCP read/write separation
- MCP Tools — All 34 tools: memory, decisions, code, findings, survey, tasks, tokens
- CLI Reference — Full command reference
- Swarm Mode — SDLC pipeline, worktrees, agent coordination
- Skills — Built-in and custom skill reference
- Storage — File layout, sharing via git
Register the marketplace in ~/.claude/settings.json (or .claude/settings.json for project-level) so team members are prompted to install:
{
"extraKnownMarketplaces": {
"aide": {
"source": {
"source": "github",
"repo": "jmylchreest/aide"
}
}
}
}Add to ~/.claude/settings.json:
{
"permissions": {
"allow": [
"Bash(aide *)",
"Bash(**/aide *)",
"Bash(git worktree *)",
"mcp__plugin_aide_aide__*"
]
}
}git clone https://github.com/jmylchreest/aide && cd aide
# Build (requires Go 1.25+ and Bun)
cd aide && go build -o ../bin/aide ./cmd/aide && cd ..
bun install && bun run build
# Claude Code
claude --plugin-dir /path/to/aide
# OpenCode
bunx @jmylchreest/aide-plugin install --projectaide version # Check binary
aide status # Full system dashboard
AIDE_DEBUG=1 claude # Debug logging (or AIDE_DEBUG=1 opencode)Reinstall:
# Claude Code
claude plugin uninstall aide && claude plugin install aide@aide
# OpenCode
bunx @jmylchreest/aide-plugin uninstall && bunx @jmylchreest/aide-plugin installSee the adapters documentation. AIDE's adapter architecture maps any tool's lifecycle events to shared core functions — skills and MCP tools work out of the box.
MIT