agent-shadow-brain

🎬 2분 분량의 v6.0.2 히어로 영상 — 음소거 상태로 자동 재생 · 🔊를 클릭하여 음소거 해제 · v6.0.2 릴리스 페이지 · 오리지널 2분 설명 영상 · 대시보드 투어

Claude Code · Cursor · Cline · Codex · Copilot · Windsurf · Kilo · Roo · OpenCode · Aider — 이 모든 것이 하나의 로컬 브레인 (local brain) 위에서 실행됩니다. 한 에이전트 (agent)가 배우는 것은 모든 에이전트가 알게 되며, 한 서브 에이전트 (sub-agent)가 발견하는 것은 모든 서브 에이전트가 상속받습니다.

🆕 v6.0.2 "Singularity" — 세계 최초의 19가지 기능. 모든 기능은 공유 가능합니다.

5가지 바이럴 아티팩트 (artifacts) — 각각 트윗에 바로 올릴 수 있는 PNG/SVG/MP4 형식으로 렌더링됩니다: 🎬Brain Replay · 🧬Brain DNA · 🗳️Hive Voice · ⏰Time Capsule · 🔬Brain Diff

14가지 고급 기능 — Spotify-Wrapped와 AI 코드베이스 (codebase)의 만남: 🎵Brain Cinema (브레인 성장을 보여주는 60초 자동 SVG 애니메이션 비디오) · 🎼Brain Sonification (당신의 코드베이스를 음악으로 변환) · 🏆Brain Trophies (25가지 업적 + 공유 카드) · 🎁Brain Holiday Card (연간 리뷰) · 🧭Brain Coach (유휴 상태 시 선제적 제안) · 🗺️Brain Quest (게임화된 온보딩 어드벤처) · 📓Brain Notebook (Jupyter 스타일의 브레인 탐색기) · ⚡Brain Reflex (로컬 모델 인라인 완성) · 🔥Brain Roast (6가지 페르소나를 통한 코믹한 코드 리뷰) · 🔮Brain Tarot (git과 브레인을 활용한 78장의 타로 점술) · 🎨Brain ASCII (터미널 아트 표현) · 😂Brain Memes (자동 생성되는 개발자 밈) · 🌌Brain 3D (Three.js 기반 회전 가능한 그래프 뷰어) · 💞Brain Doppelganger (코드베이스의 쌍둥이 찾기)

인프라 (infrastructure) — 실제 ANN HNSW 인덱스 · 헌법 레이어 (Constitution layer) · 신뢰 게이트 (Confidence Gate) · 멀티모달 비전 (multimodal vision, llava) · LoRA 증류 파이프라인 (LoRA distillation pipeline) · SWE-Bench-Lite 평가 하네스 (eval harness) · OpenTelemetry-lite 트레이싱 (tracing) · git 추적 가능한 Markdown 브레인 내보내기/가져오기.

# 30초면 충분합니다. 당신의 머신에 있는 모든 에이전트와 서브 에이전트가 더 똑똑해집니다.
npx @theihtisham/agent-shadow-brain@latest attach-all
# 또는 — 30초간의 놀라운 투어
...

🎬 Video · 📦 npm · ⭐ Star on GitHub · 📚 Docs · 🐛 Issues

# 방법 1 — 명령어 하나로 모든 에이전트를 연결하고 대시보드 실행
npx @theihtisham/agent-shadow-brain@latest attach-all
# 방법 2 — 글로벌 설치
...

설정 불필요. API 키 불필요. 100% 로컬 우선 (local-first).

35개의 새로운 모듈 + 27개의 새로운 CLI 명령어 + 7개의 샘플 아티팩트. 새로운 npm 의존성(deps) 없음. tsc-clean.

이 모든 기능은 트위터(X)에 바로 공유 가능한 PNG/SVG로 렌더링됩니다. Cursor에는 이런 기능이 없습니다. Cline에도 없습니다. 그 누구도 이런 기능은 가지고 있지 않습니다.

기능	역할
🎬	Brain Replay (브레인 리플레이)
첫날부터 발생한 모든 브레인 이벤트의 탐색 가능한 타임라인. 커서를 드래그하여 어떤 순간으로든 되돌릴 수 있습니다. SVG 내보내기 지원.
🧬	Brain DNA (브레인 DNA)
Spotify-Wrapped 스타일의 지문 카드. 8가지 성격 아키타입 (The Architect, The Debugger, …). 1080×1080 공유용 카드.
🗳️	Hive Voice (하이브 보이스)
3개의 로컬 모델이 모든 아키텍처 질문에 대해 토론하고 투표합니다. 합의, 반대, 신뢰도를 실시간으로 확인하세요. SVG 막대 그래프 제공.
⏰	Brain Time Capsule (브레인 타임캡슐)
브레인 스냅샷을 동결 + 라벨링 + 부활시킵니다. "1월 당시 우리가 React에 대해 알고 있었던 것들"과 같은 식입니다. Ed25519로 서명된 번들 제공.
🔬	Brain Diff (브레인 디프)
두 브레인 사이의 의미론적 차이(Semantic diff)를 비교합니다. 벤 다이어그램(Venn-diagram) SVG + 영어 설명 제공. "팀 A가 팀 B와 달리 배운 것은 무엇인가?"

shadow-brain dna card --out my-brain.svg # 🧬 당신의 DNA 카드를 생성합니다
shadow-brain replay export --format svg --out timeline.svg # 🎬 탐색 가능한 타임라인
shadow-brain hive-voice ask "Server Components by default?" # 🗳️ 멀티 모델 투표
...

🎵 Brain Cinema (브레인 시네마) — 자동 절차적 생성(auto-procedural) 60초 SVG 비디오 |
🎼 Brain Sonification (브레인 소니피케이션) — 당신의 코드베이스를 음악으로 (WAV) |
🏆 Brain Trophies (브레인 트로피) — 공유용 카드가 포함된 25개의 업적 |
🎁 Brain Holiday Card (브레인 홀리데이 카드) — 연간 리뷰 SVG |
🧭 Brain Coach (브레인 코치) — 10개의 선제적 유휴 상태 제안(idle-suggestion) 규칙 |
🗺️ Brain Quest (브레인 퀘스트) — 5개의 게임화된 온보딩 어드벤처 |
📓 Brain Notebook (브레인 노트북) — Jupyter 스타일의 브레인 탐색기 |
⚡ Brain Reflex (브레인 리플렉스) — 로컬 모델 인라인 완성 (inline completion) |
🔥 Brain Roast (브레인 로스트) — 코미디 스타일의 코드 리뷰 (6가지 페르소나) |
🔮 Brain Tarot (브레인 타로) — git+brain 기반의 78장 타로 점 |
🎨 Brain ASCII (브레인 ASCII) — 터미널 아트 브레인 (6가지 스타일) |
😂 Brain Memes (브레인 밈) — 자동 생성된 개발자 밈 (10가지 템플릿) |
🌌 Brain 3D (브레인 3D) — 회전 가능한 Three.js 그래프 뷰어 |
💞 Brain Doppelganger (브레인 도플갱어) — 당신의 코드베이스와 닮은 쌍둥이 찾기 |

회상 품질 (Recall quality)	메모리 구조 (Memory arch)	효율성 (Efficiency)	지능 (Intelligence)	크기 + 학습 (Size + Learning)
Rerank (BM25 + 코사인 하이브리드 (cosine hybrid))	메모리 계층 (Memory Tiers) (일화적/의미적 (episodic/semantic))	작업 메모리 (Working Memory) (LRU + 예측적 프리페치 (predictive prefetch))	모순 (Contradictions) (46개의 극성 쌍 (polarity pairs))	양자화 (Quantize) (int8 벡터, 4배 더 작음, 평균 오차 0.000298)
쿼리 확장기 (Query Expander) (유의어 + 약어 + HyDE)	통합기 (Consolidator) (중복 제거 + 추상화)	회상 캐시 (Recall Cache) (블룸 필터 (bloom filter), 65k 비트, 10k 키 기준 약 4%의 FP)	그래프 워커 (Graph Walker) (5가지 엣지 유형, 3-hop BFS)	능동적 학습기 (Active Learner) (수락/거절 피드백 편향)

실제 ANN 벡터 인덱스 (Real ANN vector index) (embeddings-v2.ts) — HNSW 스타일 그래프, M=8, 10k 벡터에 대해 100ms 미만의 회상 성능, 샤딩된 영속성 (5MB 제한), 첫 실행 시 Ollama에서 nomic-embed-text를 자동으로 가져옴

헌법 계층 (Constitution layer) — <project>/.shadow-brain/constitution.md 파서 + 핫 리로드 (hot-reload) + 주입 (injection)

신뢰도 게이트 (Confidence Gate) — 능동적 출력 필터, Brier 점수 + ECE 통계

멀티모달 비전 (Multimodal vision) — Ollama llava / llava-llama3 / bakllava 인입 (ingestion)

Markdown 브레인 내보내기/가져오기 (Markdown brain export/import) — git 추적이 가능한 .shadow-brain.md 왕복 (round-trip)

OpenTelemetry-lite 트레이싱 (OpenTelemetry-lite tracing) — OTel 호환 JSONL, 일일 로테이션

LoRA 증류 파이프라인 (LoRA distillation pipeline) (tools/lora-pipeline/) — 당신의 브레인을 Qwen2.5-Coder-1.5B 어댑터로 변환

SWE-Bench-Lite 하네스 (SWE-Bench-Lite harness) (tools/swe-bench-lite/) — 10개의 엄선된 버그, 브레인 활성화 vs 비활성화 비교, 통계적 점수 산출

30초 데모 (30-second demo): npx @theihtisham/agent-shadow-brain demo

| 새로운 브레인 모듈 (New brain modules) | 35 (25개 기능 + 10개 품질 스택) |
| 새로운 CLI 명령 그룹 (New CLI command groups) | 27 |
| 새로운 LOC (New LOC) | ~16,000 (TypeScript) |
| ... |

전체 릴리스 노트 (Full release notes): docs/launch/RELEASE_NOTES_v6.0.2.md
전략적 로드맵 (Strategic roadmap) (v7+): docs/ROADMAP-v7.md
런칭 플레이북 (Launch playbook): docs/VIRAL-PLAYBOOK.md

Shadow Brain 미사용 시	Shadow Brain v6 사용 시
모든 새로운 세션 → 에이전트가 제로 상태에서 시작	첫 번째 프롬프트 전에 2K-토큰 브리핑 주입
...	AI가 왜 그런 선택을 했는지 설명할 수 없음
	Causal Memory Chains (인과 메모리 체인)가 원인의 전체 DAG를 렌더링
두 에이전트가 동일한 파일에 접근 = 머지 지옥 (merge hell)	Collision Detective (충돌 탐지기)가 실시간으로 포착
에이전트가 작업 후 유휴 상태로 전환 — 컴퓨팅 자원 낭비	Dream Engine (드림 엔진)이 유휴 시간에 성찰하며 반사실적 (counterfactual) 추론 수행
에이전트 결정에 대한 검증 가능한 기록 없음	Ed25519로 서명된 Reputation Ledger (평판 원장) — 변조 방지 영수증
...

이것은 타사의 API를 단순히 감싸는 래퍼 (wrapper)가 아닙니다. 22개 항목 모두 실제 테스트를 거쳐 디스크에 영속화된 퍼스트 파티 (first-party) 연구 등급 구현체입니다.

Sub-Agent Brain Bridge (SABB)— 브레인 컨텍스트를 Claude Task / Cursor Composer / CrewAI / LangGraph / AutoGen 서브 에이전트로 동기화
Causal Memory Chains (인과 메모리 체인)— 모든 결정이 그 원인과 연결됨; Graphviz DOT 내보내기 지원
Dream Engine (드림 엔진)— 유휴 시간의 성찰: 재방문 / 반사실적 (counterfactual) 추론 / 통합 / 모순 발견 / 패턴 발견
Swarm Debate Protocol (스웜 토론 프로토콜)— 중요한 결정을 위한 찬성 / 반대 / 중재자 서브 에이전트 구성
Pre-Mortem Assistant (사전 부검 어시스턴트)— 시작 전 사용자 프로젝트의 과거 실패 사례를 표면화
Branch Brains (브랜치 브레인)— git 브랜치를 인식하는 메모리 컨텍스트

Agent Reputation Ledger (에이전트 평판 원장)— Ed25519로 서명된 영수증, 휴대 가능한 정확도 점수
Attention Heatmap (어텐션 히트맵)— 어떤 메모리가 결정을 형성했는지 보여주는 가중치 부여 속성
Confidence Calibration Monitor (신뢰도 보정 모니터)— Brier score + 자동 신뢰 가중치 부여
Formal Verification Bridge (형식 검증 브리지)— 자연어 규칙 → ESLint / Semgrep / LSP 진단으로 변환
Agent Collision Detective (에이전트 충돌 탐지기)— 권고 잠금 (advisory locks)을 통한 실시간 중복 탐지

Token Economy Engine (토큰 경제 엔진)— 에이전트 간 지출, 절약 제안, 라우팅 조언
Cost-Aware Sub-Agent Spawner (비용 인식 서브 에이전트 생성기)— 사소한 작업을 더 저렴한 모델로 자동 라우팅
Forgetting Curve + Sleep Consolidation (망각 곡선 + 수면 통합)— 에빙하우스 (Ebbinghaus)에서 영감을 받은 생물학적 메모리 방식

Air-Gap Mode (에어갭 모드)— 외부 네트워크 출력 없음, localhost 전용
E2E Encryption (종단간 암호화)— 저장 시 ChaCha20-Poly1305 적용
Hallucination Quarantine (환각 격리)— 의심스러운 메모리를 격리하고 7일 후 자동 만료

Voice Mode (음성 모드)— 전사(transcripts)를 위한 자연어 의도 파서 (intent parser)
Brain Garden (브레인 가든)— 살아있는 성단(constellation)으로서의 메모리를 보여주는 애니메이션 시각화
PR Auto-Review (PR 자동 리뷰)— 프로젝트 메모리를 인용하는 GitHub PR 코멘트
Team Brain Sync (WebRTC) (팀 브레인 동기화)— 서버 없는 피어 투 피어 (peer-to-peer) 공유 브레인
Brain Exchange (브레인 교환)— 큐레이션된 공유 가능한 브레인 슬라이스(brain slices) 내보내기 / 가져오기

Local-First LLM (로컬 우선 LLM)— Ollama 기본값; Anthropic / OpenAI / OpenRouter / Moonshot / Gemini / DeepSeek / Mistral 선택 가능
Hive Accelerator (하이브 가속기)— 빠른 인과적 탐색 (causal traversal) 및 6배 벡터 압축을 위한 SSSP (arXiv 2504.17033) + TurboQuant (ICLR 2026)

시작하기:

shadow-brain dash .
# → http://localhost:7341/

28개의 탭. 실시간 데이터. 완전한 제어. 모든 기능에는 실시간 모니터링과 대화형 제어 기능이 포함되어 있습니다. 미리보기:

기능: 다크 + 라이트 테마 · 커맨드 팔레트 (⌘K) · 키보드 단축키 · 토스트 알림 (toast notifications) · Chart.js 분석 · 반응형 (모바일 / 태블릿 / 데스크톱) · 실시간 WebSocket · 프로세스를 실제로 중단시키는 중지 버튼.

에이전트 (Agent)	어댑터 (Adapter)	후크 대상 (Hook target)
Claude Code	✅ 네이티브 (Native)	~/.claude/settings.json hooks.SessionStart
...

커스텀 에이전트인가요? 대시보드의 "Custom Agent Paths" 패널에 설정 경로를 추가하세요. Shadow Brain이 해당 제공자(provider) + 모델 + API 키를 자동으로 읽어옵니다.

SABB가 지원하는 서브 에이전트 (Sub-agent) 프레임워크: Claude Task, Cursor Composer, Cline Sub-step, CrewAI, LangGraph, AutoGen, 일반(generic).

Shadow Brain의 **ModelRegistry (모델 레지스트리)**는 다음 8개의 제공자를 즉시 지원합니다:

Ollama (기본값, 로컬, 무료) · Anthropic Claude · OpenAI · OpenRouter · Moonshot / Kimi · Google Gemini · DeepSeek · Mistral

여기에 독특한 Agent Proxy (에이전트 프록시) 모드가 추가됩니다: 이미 자신의 API 키로 Claude Code / Cursor / Codex를 사용 중이라면, Shadow Brain은 그들의 지능을 빌려옵니다 — 새로운 API 키 필요 없음, 추가 비용 없음.

Auto-discovery (자동 검색) 기능은 사용자의 머신에 있는 모든 에이전트 설정(config)을 읽어오므로, 키를 다시 입력할 필요가 없습니다.

지표 (Metric)	값 (Value)
Brain 모듈 (Brain modules)	48
...

# 1. 설치 (Install)
npx @theihtisham/agent-shadow-brain@latest attach-all
# 2. 대시보드 실행 (Launch the dashboard)
...

이것으로 끝입니다. Claude Code / Cursor / 기타 지원되는 에이전트에서 어떤 프로젝트든 열기만 하세요. Shadow Brain은 이미 내부적으로 실행 중입니다.

▶ 시청하려면 여기를 클릭하세요 · 모든 기능, 라이브 대시보드, 그리고 30초 설치 과정을 음성 해설과 함께 보여주는 전체 모션 그래픽 설명 영상입니다.

로컬 파일: docs/launch/shadow-brain-motion-explainer-narrated.mp4

(2:05 · 1080p · 음성 해설 포함).

# 연결(Attachment) + 생명주기(lifecycle)
shadow-brain attach-all # 감지된 모든 에이전트 연결
shadow-brain detach-all # 모든 훅(hook) 제거
...

"Shadow Brain은 서브 에이전트(sub-agents)와 함께 작동하는 최초의 오픈 소스 브레인입니다. Claude Task, Cursor Composer, CrewAI, LangGraph, AutoGen — 이 모든 것들이 마침내 하나의 npx 명령어로 컨텍스트(context)를 공유합니다. API 키는 전혀 필요 없습니다."

"Shadow Brain이 내리는 모든 AI 결정은 Ed25519로 서명됩니다. 모든 원인은 추적됩니다. 모든 충돌은 발생하기 전에 포착됩니다. 영원히 무료입니다."

"그 누구도 갖지 못한 22가지의 새로운 기능. 무료. 오픈 소스. 로컬 우선(Local-first). npx @theihtisham/agent-shadow-brain."

git clone https://github.com/theihtisham/agent-shadow-brain.git
cd agent-shadow-brain
npm install
...

이슈(Issues), PR(Pull Requests), 토론(discussions)을 환영합니다. CONTRIBUTING.md를 참조하세요.

CHANGELOG.md— 릴리스 노트
docs/versions/v6.0.0.md— v6 릴리스 상세 정보
docs/launch/HIVEMIND_VIDEO.md— 영상 제작 파이프라인
docs/launch/screenshots/— 29개의 모든 대시보드 스크린샷
SECURITY.md— 보안 정책
CODE_OF_CONDUCT.md— 커뮤니티 가이드라인

GitHub Issues— 버그 보고, 기능 요청
GitHub Discussions— 질문, 아이디어, 사례 공유
GitHub Releases— 설명 영상 MP4 + 릴리스 에셋 다운로드

Shadow Brain이 당신의 AI 에이전트를 더 똑똑하게 만든다면, 저장소를 스타(star) 해주세요 ⭐

MIT — LICENSE를 참조하세요.

자유롭게 사용, 수정, 포크(fork), 상업화할 수 있습니다. 기본적으로 로컬 우선(Local-first) 방식을 따릅니다. 오프라인, 에어갭(air-gapped) 환경, 개인정보 보호가 엄격한 기업 환경에서도 작동합니다. 텔레메트리(Telemetry)가 없으며, 외부로 데이터를 전송(phone-home)하지 않습니다. 체험판 만료 기간도 없습니다.

npx @theihtisham/agent-shadow-brain@latest attach-all