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 install

Codex CLI:

codex plugin marketplace add jmylchreest/aide
codex plugin add aide@aide
bunx @jmylchreest/aide-plugin 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 downloads automatically on first run. Skills become available immediately.

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 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 uninstall && bunx @jmylchreest/aide-plugin 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