convez.ai
MCP Server
jmylchreest

aide

jmylchreest/aide

Ver no GitHub
BomPluginScore · de 0 a 100

Multi-agent orchestration, persistent memory, and intelligent workflows for AI coding assistants. Supports Claude Code and OpenCode.

Instalação

$npx convez-ai jmylchreest/aide

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
19
Forks
5
Acompanhando
0
Saúde
42%
Último commit
há 3 dias
Versão
v0.2.1
Issues abertas
0
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.

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:

bunx @jmylchreest/aide-plugin install --platform codex

The Go binary downloads automatically on first run. Skills become available immediately.

What You Get

CapabilityWhat it does
MemoryRemembers preferences and context across sessions
DecisionsRecords architectural choices, enforces them in every session
BlueprintsSeeds best-practice decisions for Go, Rust, GitHub Actions, and more
Code IndexFast symbol search, call graphs, and references via tree-sitter
Static AnalysisDetects complexity, coupling, secrets, and code duplication
SurveyMaps codebase structure: modules, entry points, tech stack, churn hotspots
Skills23 built-in workflows triggered by natural language
SwarmParallel agents with full SDLC pipelines (design, test, implement, verify, docs)
34 MCP ToolsFull programmatic access to all capabilities above

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.

SkillExample PromptWhat Happens
swarmswarm 3 implement dashboardParallel agents with SDLC pipeline per story
plan-swarmplan swarm for the dashboardDecomposes work into stories for swarm execution
decidehelp me decide on auth strategyStructured decision interview, records choices
designdesign the auth systemTechnical spec with interfaces and acceptance criteria
surveysurvey this codebaseMaps modules, tech stack, entry points, and churn
testwrite tests for authTest suite with coverage verification
implementimplement the featureTDD — make failing tests pass
verifyverify the implementationFull QA: tests, lint, types, build, debug artifacts
docsupdate the documentationUpdates docs to match implementation
autopilotautopilot fix all failing testsPersistent — won't stop until verified complete
build-fixfix the build errorsIteratively fixes build/lint/type errors
debugdebug why login failsSystematic debugging with hypothesis testing
perfoptimize the APIPerformance profiling and optimization
reviewreview this PRSecurity-focused code review
patternscheck code healthSurface code quality issues via static analysis
assess-findingsassess findingsTriage: read code, accept noise, keep real issues
code-searchfind all auth functionsSearch symbols, find call sites
memoriseremember I prefer vitestStores info for future sessions
recalldo you remember the testing decision?Searches memories and decisions
forgetforget the old auth decisionSoft-delete or hard-delete memories
gitcreate a worktree for this featureGit operations and worktree management
worktree-resolvemerge worktreesMerges worktree branches with conflict resolution
context-usagehow 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/.

Configuration

VariableDescription
AIDE_DEBUG=1Enable debug logging (logs to .aide/_logs/)
AIDE_FORCE_INIT=1Force initialization in non-git directories
AIDE_CODE_WATCH=1Enable file watching for auto-reindex
AIDE_CODE_WATCH_DELAY=30sDelay before re-indexing after file changes
AIDE_INDEX_NON_VCS=1Allow watcher/indexing in non-VCS dirs (default: refuse)
AIDE_INDEX_WORKERS=NParallel parser workers for code indexing (default: NumCPU, capped at 32)
AIDE_MEMORY_INJECT=0Disable memory injection
AIDE_MEMORY_SCORING_DISABLED=1Disable memory scoring (use chronological order)
AIDE_MEMORY_DECAY_DISABLED=1Disable recency decay in memory scoring
AIDE_SHARE_AUTO_IMPORT=1Auto-import shared decisions/memories on start

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

PlatformBinary
Linux x64aide-web-linux-amd64
Linux arm64aide-web-linux-arm64
macOS x64aide-web-darwin-amd64
macOS arm64aide-web-darwin-arm64
Windows x64aide-web-windows-amd64.exe
Windows arm64aide-web-windows-arm64.exe
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

Ver o original no GitHub

Bom para

Relacionados