Claude Code 세션을 자율 운영자로 변환하는 TypeScript MCP 서버입니다. 목표를 분해하고, 여러 프로젝트에 걸쳐 작업자 세션을 생성 및 조정하며, 2계층 지속적 메모리를 관리하고, 가드레일을 적용하며, 사후 인간 검토를 통해 학습합니다.
npm install -g claude-operator
claude-operator init
claude-operator startinit은 ~/.claude-operator/ (SQLite DB, 버스 디렉토리, 설정)를 스캐폴딩합니다.
start는 stdio에서 MCP 서버를 실행하고 http://localhost:7373에서 대시보드를 실행합니다.
Related MCP server: claude-swarm
~/.claude/settings.json에 추가하세요:
{
"mcpServers": {
"claude-operator": {
"command": "claude-operator",
"args": ["start", "--mcp"]
}
}
}또는 로컬 개발 빌드를 가리키세요:
{
"mcpServers": {
"claude-operator": {
"command": "node",
"args": ["/path/to/claude-operator/packages/server/dist/server.js"]
}
}
}Operator session (Claude Code)
│ MCP tools (10)
▼
┌─────────────────────────────────┐
│ claude-operator MCP server │
│ ┌──────────┐ ┌─────────────┐ │
│ │ SQLite │ │ File bus │ │
│ │ WAL+FTS5│ │ heartbeat │ │
│ └──────────┘ └─────────────┘ │
│ ┌──────────────────────────┐ │
│ │ Monitor loop (30s poll) │ │
│ └──────────────────────────┘ │
└────────────┬────────────────────┘
│ spawn / bus read-write
┌────────┴────────┐
▼ ▼
Worker A Worker B
(git worktree) (git worktree)
operator/w-abc operator/w-def2계층 메모리 — 1계층(휘발성, 30일 후 자동 만료) 및 2계층(지속성, 인간 확인 완료). 운영자가 분류를 제안하면 대시보드에서 인간이 확인합니다(pending_classification=TRUE).
파일 버스 — 기본 작업자↔운영자 상태 채널. 작업자는 <bus-dir>/<worker-id>.json에 하트비트를 기록합니다. 모니터 루프는 응답 없는 작업자(2분 이상 하트비트 없음)를 감지하여 실패로 표시합니다.
가드레일 — 도구 호출 전에 적용되는 JSON 규칙입니다. set_guardrail을 통해 설정하고 get_guardrails를 통해 검사합니다.
도구 | 설명 |
| 목표, 프로젝트 경로, 우선순위, 제약 조건이 포함된 작업 생성 |
| 격리된 git 작업 트리에서 Claude Code 작업자(이름 지정 또는 헤드리스) 실행 |
| 작업자 상태, 하트비트 경과 시간, 현재 작업 폴링 |
| 작업 완료 표시, 작업 트리 브랜치 병합, 정리 |
| 운영자 메모리 전체에 대한 FTS5 전문 검색 |
| 계층 및 신뢰도와 함께 메모리 항목 작성/업데이트 |
| 가드레일 규칙 추가 또는 업데이트 |
| 활성 가드레일 규칙 나열 |
| 파일 버스를 통해 실행 중인 작업자에게 지침 전송 |
| 사후 학습을 위해 인간의 판단 기록 |
http://localhost:7373 — 작업 보드, 작업자 상태, 가드레일 편집기, 메모리 브라우저, 판단 기록 로그, SSE 로그 스트림.
claude-operator init # scaffold config + DB
claude-operator start # start MCP server + dashboard
claude-operator status # print active workers + tasks
claude-operator retro # open judgment call loggit clone https://github.com/MoyGulati/claude-operator
cd claude-operator
pnpm install
pnpm build
pnpm test # 39 tests
./verify.sh # full gate (build + test)요구 사항: Node 24+, pnpm 10+.
MIT
This server cannot be deployed
Persistent, governed institutional memory for Claude Code — specs, decisions, learnings.
Persistent cross-session memory shared by Codex, Claude Code, ChatGPT, and other AI agents.
Adaptive plan/build/review cycles for AI coding assistants, persisted across sessions.
Build and supervise fleets of agents from Claude Code, Codex or Cursor. Connects over OAuth.
