One brain, many harnesses. Portable .agent/ folder (memory + skills + protocols) that plugs into Claude Code, Cursor, Windsurf, OpenCode, OpenClaw, Hermes, or DIY Python — and keeps its knowledge when you switch.
이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.
코딩 에이전트 하네스 전반에서 하나의 이식 가능한 메모리 및 스킬 레이어를 유지하여, 도구를 전환해도 에이전트의 작동 방식이 초기화되지 않도록 합니다.
이식 가능한 .agent/ 폴더(메모리 + 스킬 + 프로토콜)로, Claude Code, Cursor, Windsurf, OpenCode, OpenClaw, GitHub Copilot CLI, Google Gemini CLI, Hermes, Pi Coding Agent, Codex, Antigravity 또는 DIY Python 루프에 연결할 수 있으며, 전환 시 지식을 유지합니다.
또한 로컬 데이터 레이어를 포함하여 한 곳에서 전체 에이전트 제품군(하네스 활동, cron 실행, 활성 에이전트, 토큰/비용 추정, KPI 요약, 사용자 정의 리소스 카테고리, 스크린샷 준비 완료 일일 대시보드)을 모니터링할 수 있습니다.
그리고 승인되고 편집된 실행을 로컬 플라이휠 아티팩트(추적 레코드, 컨텍스트 카드, 평가 사례, 훈련 준비 JSONL, 준비 메트릭)로 전환할 수 있으며, 모델을 훈련하거나 원격 측정을 보낼 필요가 없습니다.
마이너 릴리스. codejunkie99/brain(외부 git 기반 장기 기억 CLI/TUI/MCP 서버)에 대한 선택적 브리지를 추가합니다. Brain의 Rust 워크스페이스를 agentic-stack에 벤더링하지 않습니다.
agentic-stack brain.... 일반 agentic-stack CLI에서 Brain 상태 확인, 프로젝트 온보딩, 글로벌 메모리 검색, 내구성 있는 노트 작성, Brain doctor/TUI 실행 또는 MCP stdio 명령 출력..agent/ 프로젝트에는 이제 .agent/tools/brain_bridge.py가 포함되어, 호스트 에이전트가 교차 프로젝트 회상이 필요한 작업에서 Brain을 명시적으로 호출할 수 있습니다.brain 스킬은 에이전트가 Brain 메모리를 쿼리하거나 기록할 시기를 가르치고, 비밀 처리를 명시적으로 유지합니다.전체 목록은 CHANGELOG.md를 참조하세요.
마이너 릴리스. 열린 PR 큐를 정리하고 Copilot CLI, Gemini, Mission Control 및 의미론적 학습 철회 작업의 결합된 프로덕션 표면을 제공합니다.
패치 릴리스. PR #49의 프로덕션 준비 시작 가이드를 제공하고 첫 실행 배너의 온보딩 버전 드리프트를 수정합니다.
마이너 릴리스. agentic-stack upgrade 및 agentic-stack sync-manifest를 추가하여 설치된 프로젝트가 어댑터 설정이나 사용자 메모리를 덮어쓰지 않고 새로운 .agent 인프라 및 스킬 메타데이터를 가져올 수 있도록 합니다.
agentic-stack upgrade --dry-run을 실행하여 스켈레톤 소유의 .agent 파일 업데이트를 미리 본 다음, agentic-stack upgrade --yes를 실행하여 적용합니다.agentic-stack sync-manifest를 실행하여 설치된 SKILL.md 프론트매터에서 .agent/skills/_manifest.jsonl을 재구축합니다.CLAUDE.md, .claude/settings.json, 개인/의미론/일화/작업 메모리, 후보 및 기존 스킬 디렉토리를 그대로 둡니다.agentic-stack doctor는 이제 Claude Code 후크 명령이 누락된 .agent 파일을 가리키거나 후크 스크립트가 존재하지만 연결되지 않은 경우 경고합니다.마이너 릴리스. 라이브 캔버스 다이어그램 및 스킬 로컬 스냅샷 저장소를 위한 선택적 tldraw 시드 스킬을 추가합니다. 베타이며 기본적으로 꺼져 있습니다.
tldraw 시드 스킬. MCP 서버를 통해 http://localhost:3030의 라이브 캔버스에서 그리고, 다이어그램, 스케치, 와이어프레임, 순서도 및 화이트보드 작업을 수행합니다..agent/skills/tldraw/store.py snapshot으로 가치 있는 캔버스를 저장하고, 나중에 다섯 번째 메모리 레이어로 취급하지 않고 나열, 로드 및 보관합니다.tldraw.enabled: false를 기본값으로 작성합니다. 활성화한 후 사용자는 adapters/_shared/tldraw-mcp.json을 하네스 MCP 구성에 수동으로 병합합니다.동일한 .agent/ 브레인에 대해 여러 에이전트 하네스를 실행하는 팀을 위한 두 가지 로컬 우선 데이터 기능을 추가했습니다.
data-layer 시드 스킬. Claude Code, Hermes, OpenClaw, Codex, Cursor, OpenCode 및 사용자 정의 루프에 걸쳐 로컬 대시보드 내보내기(하네스 이벤트, cron 타임라인, KPI 요약, 토큰/비용 추정, 카테고리, dashboard.html, daily-report.md)를 생성합니다. 이 스킬은 또한 터미널 대시보드를 표시하기 위한 주입된 자연어 인터페이스 역할을 합니다.data-flywheel 시드 스킬. 승인되고 편집된 실행을 추적 레코드, 컨텍스트 카드, 평가 사례, 훈련 준비 JSONL 및 플라이휠 메트릭으로 내보냅니다. 로컬 전용이며 모델에 구애받지 않습니다. 아티팩트를 준비하지만 모델을 훈련하거나 외부 API를 호출하지 않습니다.루트 DESIGN.md / Google Stitch 워크플로를 위한 design-md 시드 스킬을 추가하고, macOS 기본 brew 사용자가 첫 실행 시 겪는 Python 3.9 충돌을 수정했습니다.
v0.9.0과 작동하는 pi 어댑터 사이의 격차를 해소하고, 모든 Python 작성기/판독기에 걸쳐 시간대를 정리하여 드림 사이클이 UTC 감쇠 창에 대해 드리프트하지 않도록 했습니다.
매니페스트 기반 어댑터 시스템: 모든 하네스는 이제 adapter.json으로 선언되고, 공유 Python 백엔드에 의해 적용되며, 동사 하위 명령 또는 대화형 TUI를 통해 관리됩니다. 크로스 플랫폼(POSIX + Windows)이며 동시 쓰기 보호, ./install.sh doctor를 통한 v0.9 이전 마이그레이션, 공유 파일 소유권 추적을 제공하여 하나의 어댑터를 제거해도 다른 어댑터가 고아가 되지 않도록 합니다.
https://x.com/Av1dlive 제작
# tap + 설치 (일회성 — 두 줄 모두 필요)
brew tap codejunkie99/agentic-stack https://github.com/codejunkie99/agentic-stack
brew install agentic-stack
# 모든 프로젝트에 브레인 추가 — 온보딩 마법사가 자동으로 실행됩니다
cd your-project
agentic-stack claude-code
# 또는: cursor | windsurf | opencode | openclaw | copilot-cli | gemini | hermes | pi | codex | standalone-python | antigravity# 클론 + 네이티브 설치 프로그램 실행
git clone https://github.com/codejunkie99/agentic-stack.git
cd agentic-stack.\install.ps1 claude-code C:\path\to\your-projectbrew update && brew upgrade agentic-stack
agentic-stack dashboardgit clone https://github.com/codejunkie99/agentic-stack.git
cd agentic-stack &&./install.sh claude-code # mac / linux / git-bash
# 또는 Windows PowerShell:.\install.ps1 claude-code
# 어댑터: claude-code | cursor | windsurf | opencode | openclaw | copilot-cli | gemini | hermes | pi | codex | standalone-python | antigravity첫 번째 ./install.sh 후, 동사 스타일 하위 명령으로 프로젝트를 관리합니다(install.sh 및 install.ps1 모두에서 작동):
PowerShell은 동일한 동사를 사용합니다(예: .\install.ps1 dashboard).
codejunkie99/brain은 git 기반 장기 기억 바이너리 및 MCP 서버입니다. agentic-stack은 이제 이를 Rust 워크스페이스를 벤더링하는 대신 선택적 외부 메모리 레이어로 취급합니다.
먼저 Brain을 설치합니다:
brew install codejunkie99/tap/brain그런 다음 프로젝트에서 확인하거나 연결합니다:
agentic-stack brain status
agentic-stack brain onboard --agents codex,cursor --yes
agentic-stack brain ask "auth decisions"
agentic-stack brain note "Use PKCE for local OAuth flows."
agentic-stack brain mcp-command설치된 .agent/ 프로젝트는 또한 python3.agent/tools/brain_bridge.py와 brain 시드 스킬을 얻어, 호스트 에이전트가 교차 하네스 장기 기억이 필요한 작업에서 Brain 메모리를 쿼리하거나 기록할 수 있습니다.
인수 없이 ./install.sh만 실행하면 새 프로젝트에서 다중 선택 마법사가 열립니다. 실제로 사용하는 모든 하네스를 확인하고 Enter를 누르면 각각 설치됩니다. 마법사는 이미 디스크에 있는 하네스를 자동 감지하여 미리 선택합니다. 이미 install.json이 있는 프로젝트에서 기본 대화형 ./install.sh는 대시보드를 엽니다. TTY가 아닌 셸(CI)에서는 스크립트 안전을 유지하며 TUI를 열지 않고 사용 가능한 하위 명령을 출력합니다.
v0.9 이전에서 업그레이드하시나요? 먼저 ./install.sh doctor를 실행하세요. 디스크의 어댑터 신호에서 install.json을 합성하여 새 백엔드가 추적할 수 있도록 합니다. 마이그레이션 없이 위에 설치하면 이전 설치가 고아가 됩니다.
brew upgrade 후 이미 설치된 프로젝트를 업그레이드하시나요? 프로젝트에서 먼저 agentic-stack upgrade --dry-run을 실행한 다음 agentic-stack upgrade --yes를 실행하여 스켈레톤 소유의 .agent 인프라(harness/**/.py, 최상위 memory/.py, tools/*.py, 생성된 스킬 인덱스 및 새 스킬 디렉토리)만 새로고침합니다. CLAUDE.md, .claude/settings.json, 개인/의미론/일화/작업 메모리, 후보 또는 기존 스킬 디렉토리를 다시 쓰지 않습니다. _manifest.jsonl이 설치된 SKILL.md 파일에서 드리프트된 경우 복구 명령으로 agentic-stack sync-manifest를 사용할 수 있습니다.
인수 없이 ./install.sh(어댑터 이름 없음)를 실행하면 마법사가 다중 선택 하네스 단계로 시작합니다. 12개 어댑터를 모두 나열하고, 디스크에서 감지된 항목을 미리 선택하며, 스페이스 + Enter로 확인한 각 항목을 설치합니다. 설치 후 기본 설정 흐름이 실행됩니다.
./install.sh 를 직접 실행하면 기본 설정 흐름만 실행됩니다.
어느 쪽이든 기본 설정 단계는 .agent/memory/personal/PREFERENCES.md를 채웁니다. 이 파일은 AI가 모든 세션 시작 시 읽는 첫 번째 파일이며, .agent/memory/.features.json에 기능 토글 파일을 작성합니다.
여섯 가지 기본 설정 질문(각각 Enter로 건너뛸 수 있음):
| 질문 | 기본값 | ||
|---|---|---|---|
| 당신을 뭐라고 부를까요? | (건너뛰기) | ||
| 기본 언어는 무엇인가요? | unspecified |
||
| 설명 스타일은 무엇인가요? | concise |
||
| 테스트 전략은 무엇인가요? | test-after |
||
| 커밋 메시지 스타일은 무엇인가요? | conventional commits |
||
| 코드 리뷰 깊이는 무엇인가요? | critical issues only |
추가로 선택적 기능 단계(옵트인, 기본적으로 꺼짐):
| 기능 | 기본값 | ||
|---|---|---|---|
FTS 메모리 검색 활성화 [BETA] |
no |
||
tldraw 시각적 캔버스 활성화 [BETA] |
no |
플래그:
agentic-stack claude-code --yes # 모든 기본값 수락, 베타 끔 (CI/스크립트)
agentic-stack claude-code --reconfigure # 기존 프로젝트에서 마법사 재실행언제든지 .agent/memory/personal/PREFERENCES.md를 편집하여 규칙을 세분화하거나 .agent/memory/.features.json을 편집하여 기능 토글을 전환할 수 있습니다.
한 프로젝트 브레인의 이식 가능한 부분을 Codex, Cursor, Windsurf 또는 터미널 전용 프로젝트로 온보딩 스타일 TUI로 이동합니다:
마법사는 일반 언어 의도를 전송 계획으로 변환하고, 대상 하네스 및 메모리 범위를 검토할 수 있게 하며, 내보내기 전에 비밀 같은 콘텐츠를 차단하고, 다음 환경에서 실행할 수 있는 한 줄 curl 명령을 내보냅니다. move my memory의 경우 기본 설정, 수락된 학습, 스킬, 작업 메모리, 일화/기록 로그 및 후보 학습을 포함합니다. 가져오기는 번들을 풀고 SHA-256 다이제스트를 확인하며, 기본 설정 및 수락된 학습을 병합하고, 선택한 스킬을 복사하고, 선택한 메모리 파일을 복원하며, i
[...truncated...]