AIDE - AI Development Environment

Persistent memory, code intelligence, and multi-agent orchestration for AI coding assistants. Works with Claude Code and OpenCode.

Install

Claude Code:

claude plugin marketplace add jmylchreest/aide
claude plugin install aide@aide

OpenCode:

bunx @jmylchreest/aide-plugin install

The Go binary downloads automatically. 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:

Help me decide on the coding standards, error handling strategy, testing approach,
and architecture patterns for this project. I want to enforce SOLID, DRY, Clean Code,
and idiomatic language best practices.

The decide skill works through each topic in turn, recording separate decisions that persist across every future session. 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 32 tools: memory, decisions, code, findings, survey, tasks
• 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+)
cd aide && go build -o ../bin/aide ./cmd/aide && cd ..
npm install && npm 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