영속 메모리(Persistent memory), 코드 인텔리전스(code intelligence) 및 다중 에이전트 오케스트레이션(multi-agent orchestration)을 통한 AI 코딩 어시스턴트. Claude Code, OpenCode, 그리고 Codex CLI와 함께 작동합니다.

사전 요구 사항 (Prerequisite): Bun — 유일한 런타임 종속성입니다. Go 바이너리는 자동으로 다운로드됩니다.

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는 플러그인 후크 지원 기능이 없습니다

Codex 플러그인은 MCP 서버와 스킬(Skills)을 제공하며 ($<name> 또는 /skills로 호출), 설치 단계에서 라이프사이클 후크를 추가합니다. 플러그인 지원 기능이 없는 구형 Codex 버전의 경우, 설치 단계만으로 모든 것이 구성됩니다.

Go 바이너리는 플랫폼별 npm 패키지로 배포되므로, 설치 시 디스크에 저장되며 (구형 설정은 첫 실행 시 다운로드하는 방식으로 폴백합니다). 스킬은 즉시 사용 가능해집니다.

설치(Install)는 opencode.json 파일에 정확한 버전을 고정시키며; 업그레이드하려면 @latest로 다시 실행해야 합니다. 버전 고정이 중요한 이유에 대해서는 OpenCode 설정을 참고하십시오.

Survey this codebase and help me understand its structure.

AIDE는 심볼을 인덱싱하고, 모듈, 기술 스택, 진입점(entry points), 그리고 git 변경이 활발한 지점(git churn hotspots)을 발견하여 전체적인 그림을 제시합니다. 전체 가이드

선별된 모범 사례로 부트스트랩한 후 사용자 정의할 수 있습니다:

aide blueprint import go go-github-actions # 블루프린트에서 결정 사항 시드(seeds decisions) 가져오기
aide blueprint import --detect # 또는 프로젝트 마커에서 자동 감지하기

그런 다음, 프로젝트별 선택을 위해 decide 스킬로 다듬습니다:

Help me decide on the auth strategy and database schema for this project.

블루프린트는 언어 관용구(language idioms), 도구링(tooling), CI/CD, 그리고 일반적인 함정들을 다룹니다. decide 스킬은 프로젝트별 아키텍처 선택을 처리합니다. 이 두 가지 모두 향후 모든 세션에 걸쳐 지속됩니다. 전체 가이드

결정 사항과 메모리를 git 친화적인 마크다운으로 내보낸 다음 커밋합니다:

aide share export # .aide/shared/ 에 작성하기
git add .aide/shared && git commit -m "share: team decisions"

.claude/settings.json에 AIDE_SHARE_AUTO_IMPORT=1을 추가하는 팀원들은 세션 시작 시 자동으로 가져오게 됩니다. 결정 사항은 주제별로 추가 전용(append-only)이며 (새로운 것이 덮어쓰고, 기록은 유지됨); 메모리는 ULID를 통해 병합됩니다 (더 새로운 편집이 승리함).

AIDE가 없는 팀원도 폴더를 사용할 수 있습니다. 각 .aide/shared/decisions/*.md와 .aide/shared/memories/*.md는 구조화된 프런트매터(frontmatter)를 가진 자체 포함 마크다운 파일이므로, 어떤 AI 어시스턴트든 이를 컨텍스트로 가져올 수 있습니다. 짧은 DECISIONS.md / MEMORIES.md 설명서가 내보내기와 함께 작성되어 형식을 문서화합니다. 전체 가이드

스킬은 키워드에 의해 트리거되는 마크다운 워크플로우입니다. 자연스럽게 입력하면 됩니다 — 매칭을 트리거하는 것은 느슨(fuzzy)합니다.

커스텀 스킬 (Custom skills): .aide/skills/my-skill.md 파일을 생성하여 사용합니다.

YAML 프론트매터(frontmatter)에 name, triggers를 포함하고, 마크다운 본문으로 작성합니다. 이 파일은 .aide/skills/ 디렉토리와 다음 위치의 플러그인 번들에서 자동 발견됩니다:

skills/
plugin-bundled > ~/.aide/skills/

aide status # 시스템 대시보드
aide code index # 코드베이스 심볼 색인
aide code search

`.claude/settings.json`에 추가하세요

:

{
"permissions": {
"allow": [
...

git clone https://github.com/jmylchreest/aide && cd aide

빌드 (Go 1.25+ 및 Bun 필요)

cd aide && go build -o ../bin/aide ./cmd/aide && cd ..
...

aide version # 바이너리 확인
aide status # 전체 시스템 대시보드
AIDE_DEBUG=1 claude # 디버그 로깅 (또는 AIDE_DEBUG=1 opencode)

**재설치:**

Claude Code

claude plugin uninstall aide && claude plugin install aide@aide

OpenCode

...

어댑터 문서를 참조하세요. AIDE의 어댑터 아키텍처는 모든 도구의 라이프사이클 이벤트를 공유 코어 기능(skills 및 MCP 도구)에 매핑하여 별도의 설정 없이 작동합니다.

MIT