Git이 코드 이력을 남기듯, HUGININ은 AI 결정 이력을 남긴다.
huginin CLI는 Claude Code · Antigravity(agy) · Codex와 함께 일할 때,
git commit 시점의 AI 세션을 자동으로 수집하고 CLI 간 컨텍스트를 이어주는 도구입니다.
This is the open-source CLI for HUGININ — an AI decision journal that records why your code changed, not just what changed. The CLI runs entirely on your machine; it reads local AI session logs and ships commit-linked events to your team workspace.
2026-07-24.8.26.45.mov
Ctrl+\ 로 Claude → agy → Codex 전환 — 전환 시 대화 맥락이 자동으로 따라갑니다.
- 자동 수집 — post-commit hook이 커밋과 최근 AI 세션(JSONL)을 매칭해 기록. 커밋을 막거나 늦추지 않습니다
- TUI 멀티플렉서 —
huginin하나로 claude · agy · codex를 실행하고Ctrl+\로 전환. 전환 시 대화 맥락이 따라갑니다 (각 CLI의 공식 launch 플래그 사용) - 컨텍스트 핸드오프 — 어제 claude로 작업했다면 오늘 agy가 그 맥락을 알고 시작
- backfill / import — 과거 커밋 소급 수집, 명세·제약 문서 임포트
curl -sSL https://huginin.com/install.sh | bash
huginin login
cd your-project && huginin setupmacOS · Linux (arm64/amd64) 지원.
HUGININ은 MCP(Model Context Protocol) 서버를 제공합니다. Claude Code나 LobeHub에 연결하면 AI가 구현 시작 전에 팀 결정 이력을 자동으로 검색합니다.
1단계 — 서비스 토큰 발급 (1회)
huginin login mcp-token2단계 — Claude Code 설정 (.mcp.json 또는 Claude Desktop claude_desktop_config.json)
{
"mcpServers": {
"huginin": {
"url": "https://huginin-server-production.up.railway.app/mcp",
"type": "sse",
"headers": {
"Authorization": "Bearer <발급된 토큰>"
}
}
}
}제공 tools:
| Tool | 설명 |
|---|---|
recall_decisions |
자연어 쿼리로 팀 과거 결정 의미 검색 — 구현 시작 전 자동 호출 |
collect_event |
AI 세션 이벤트 수동 수집 (hook이 자동 처리하므로 직접 호출 불필요) |
go build -o huginin .
go test ./...Go 1.25+. 외부 시스템 의존성 없음.
- AI 세션 원본 로그는 당신의 머신을 떠나지 않습니다 — CLI는 읽기만 합니다
- 서버로 가는 것은 커밋 시점에 매칭된 이벤트(프롬프트·응답·diff)뿐이며, 워크스페이스 단위로 격리됩니다
- CLI 간 컨텍스트 핸드오프는 로컬 파일 간에만 일어납니다
- 수집을 원하지 않는 레포에는 hook을 설치하지 않으면 됩니다
무엇이 어디로 가는지는 Docs — 어떤 데이터가 어디로 가는가에 정리되어 있습니다.
interfaces/cli/ — 커맨드 (setup, hook, backfill, import, ...)
interfaces/tui/ — TUI 셸 + PTY 멀티플렉서 (모드 트래커, 컨텍스트 핸드오프)
application/ — 유스케이스
infrastructure/ — config, http, keystore
Apache-2.0 — CLI는 오픈소스로 유지됩니다. 팀 워크스페이스·대시보드·정제 파이프라인은 huginin.com의 클라우드 서비스입니다.