동료들이 CLI에서 무슨 작업을 하는지, 토큰은 얼마나 쓰는지 real-time으로 확인할 수 있습니다
npm i -g mohani
mohani startWindows 설치 파일로 받고 싶다면: Releases 페이지 →
Mohani-Setup-*.exe다운로드 → 실행. (Node 환경 없이 바로 사용)
개발에 참여하고 싶다면: devsetting.md — 한 줄 (
npm run dev)로 백엔드 + 에이전트 + Electron + 인프라 한 번에 기동.
| 용어 | 의미 |
|---|---|
| 활동(Activity) | AI CLI에서 사용자가 던진 프롬프트 한 건 — 전체 본문 + 도구 호출·결과까지 팀에 노출 |
| 이벤트(Event) | 활동의 라이프사이클 단위 (UserPromptSubmit / PreToolUse / PostToolUse / SessionStart / SessionEnd / Stop) |
| 팀(Team) | 팀 코드 6자(예: ABC123)로 식별되는 친구 그룹 |
| 피드(Feed) | 팀원의 활동이 시간순으로 흐르는 라이브 스트림 — 프롬프트·도구 결과 전체가 보임 |
| 친구 그리드 | 팀원 카드 격자 — 활동 중/idle, 토큰 누적, 마지막 프롬프트 |
| 마스킹 | AWS/GCP 키, JWT, password, 이메일, 홈 경로 등 민감정보 자동 ●●● (공유 범위와 무관하게 항상 적용) |
| 비공개 모드 | 즉시 송신 차단 토글 — 다음 활동부터 팀에 안 보임 |
핵심 흐름: 친구가 Claude Code에서 무슨 질문을 던졌는지, 어떤 도구를 어떻게 호출했고 결과가 무엇이었는지 거의 실시간으로 보임. 마스킹은 민감정보 한정으로 동작하고, 본인이 노출 자체를 끄고 싶으면 비공개 모드로 즉시 차단.
graph TB
CC[Claude Code]
Codex[Codex CLI]
subgraph Client["Desktop Client"]
Hook[Hook Bridge<br/>~/.claude/settings.json]
Watcher[Codex Watcher<br/>~/.codex/sessions/*.jsonl tail]
Daemon[Local Daemon<br/>:24555]
Renderer[Electron Renderer<br/>Vite Bundle]
end
subgraph Cloud["Cloud (Render)"]
Server[Application Server<br/>Spring Boot, REST + STOMP, :8080]
PG[(PostgreSQL)]
Redis[(Redis)]
end
ImgBB[(ImgBB<br/>api.imgbb.com)]
CC -->|hook 호출| Hook
Hook --> Daemon
Codex -.->|세션 jsonl 기록| Watcher
Watcher --> Daemon
Daemon -->|REST 이벤트 송신| Server
Renderer <-->|REST + STOMP 구독| Server
Renderer -->|이미지 업로드| ImgBB
Server --> PG
Server --> Redis
| 요소 | 책임 |
|---|---|
| Hook Bridge | Claude Code의 ~/.claude/settings.json에 안전 머지된 명령들 — 이벤트 진입점. Stop 이벤트에서 transcript_path로 전달된 JSONL을 재파싱해 정확한 토큰·마지막 assistant turn 추출 |
| Codex Watcher | Codex CLI는 hook이 없으므로 ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl을 tail하여 user_message/agent_message를 캡처 |
| Local Daemon | Hook 이벤트 + Codex 세션 입력 수신, 마스킹 적용, 활동 직렬화, 서버 송신 |
| Electron Renderer | 친구 그리드·피드·비공개 모드 토글 UI — 라이브 피드는 STOMP 구독으로 수신 |
| Application Server | 인증·팀·이벤트 인제스트·STOMP 브로드캐스트 |
| PostgreSQL | 활동·팀·계정 영속 저장 |
| Redis | 세션·통계 ZSET (실시간 토큰 누적·랭킹) |
| ImgBB | 채팅 이미지 외부 위임 — 서버는 이미지 바이트 무관 |
모노레포 구조:
| 폴더 | 무엇 |
|---|---|
backend/ |
Spring Boot 3.4.3 + Redis + PostgreSQL — Application Server |
agent/ |
Node 20 글로벌 npm mohani — Local Daemon + Hook Bridge + CLI |
electron/ |
Electron + Vite + React + STOMP.js — Renderer |