AIDE - AI Development Environment
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.
Install
Claude Code:
claude plugin marketplace add jmylchreest/aide
claude plugin install aide@aide
OpenCode:
bunx @jmylchreest/aide-plugin@latest install
Codex CLI:
codex plugin marketplace add jmylchreest/aide
codex plugin add aide@aide
bunx @jmylchreest/aide-plugin@latest install --platform codex # hooks only โ Codex has no plugin hook support
The Codex plugin provides the MCP server and skills (invoke with $<name> or /skills); the install step adds lifecycle hooks. On older Codex versions without plugin support, the install step alone configures everything.
The Go binary ships as a per-platform npm package, so it lands on disk with the install (older setups fall back to downloading it on first run). Skills become available immediately.
Install pins the exact version in opencode.json; re-run it with @latest to upgrade. See OpenCode setup for why the pin matters.
What You Get
Get Started
Existing project โ understand the codebase:
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
New project โ set up guardrails:
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 markers
Then 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
Share decisions with your team:
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
Skills are markdown workflows triggered by keywords. Type naturally โ trigger matching is fuzzy.
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/.
Configuration
CLI Reference
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 version
aide-web
Optional web dashboard for monitoring aide daemon instances โ status, memories, decisions, findings, code search, and more.
Download: Latest release
aide-web --port 8080 --open
Documentation
Full 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
Advanced Installation
Claude Code โ Marketplace for Teams
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"
}
}
}
}
Claude Code โ Permissions
Add to ~/.claude/settings.json:
{
"permissions": {
"allow": [
"Bash(aide *)",
"Bash(**/aide *)",
"Bash(git worktree *)",
"mcp__plugin_aide_aide__*"
]
}
}
From Source
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@latest install --project
Troubleshooting
aide 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@latest uninstall && bunx @jmylchreest/aide-plugin@latest install
Adding Support for New Assistants
See 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.
License
MIT