cc-haha

AI Agent OrchestrationskillTypeScript

★ 14,457주당 +186조회 5

무엇인가

cc-haha는 Claude Code와 각종 에이전트를 데스크톱 앱 안에서 실행·관리하도록 작업 절차를 고정하는 로컬 우선 워크스페이스다. 세션 시작 방식, 권한 승인 단계, 변경 검토 순서, 모델 선택, 서브에이전트 구성이라는 영역을 규율한다.

어떻게 동작하나

단일 SKILL.md가 아니라 Electron 데스크톱 앱이 Claude Code CLI를 감싸는 구조로 동작한다. 세션은 탭으로 관리되고 Cmd+K 전역 검색으로 모든 세션을 가로질러全文 검색한다. 새 세션은 저장소 브랜치를 고르고 현재 작업 트리와 격리 Worktree 중 하나를 선택해 시작한다. 권한은 다섯 단계로 나뉘어 위험 명령·도구 호출·AI 되묻기가 앱에서 승인되고, MCP 서버는 STDIO·Streamable HTTP·SSE 전송과 프로젝트 사설·공유·전역 세 범위로 GUI에서 등록한다. SubAgent는 모델·도구·권한 모드를 골라 생성하고, 스킬은 ClawHub·SkillHub 마켓에서 설치한다.

무엇과 다른가

CLAUDE.md·AGENTS.md 같은 텍스트 규칙 파일은 모델에 지시를 주입할 뿐 실행 경로를 강제하지 않는다. cc-haha는 규칙을 런타임 계층에 둔다. Worktree 격리, 승인 게이트, 파일별 Diff 뷰, 모델 요청 추적이 앱 수준에서 강제되고, 세션·모델·도구 구성이 GUI 상태로 저장된다. 프롬프트를 직접 쓰는 방식과 달리 실행 전후 검토 지점이 고정된다.

어떻게 쓰나

Releases에서 macOS·Windows·Linux 설치 패키지를 받아 실행하고, 첫 실행 후 설정에서 모델 제공자·API Key·기본 모델을 지정한다. 소스에서 CLI를 직접 돌리려면 bun install, cp .env.example .env, ./bin/claude-haha 순으로 실행한다.

전제와 한계

Claude Code를 대상으로 하며 데스크톱 앱이므로 macOS·Windows·Linux 중 하나가 필요하다. 정식 macOS 릴리스는 서명·공증되지만 draft/unsigned 패키지는 수동 허용이 필요하고, Windows 미서명 패키지는 SmartScreen 경고가 뜬다. H5 원격 접속과 IM 연동은 별도 채널로 붙고, Computer Use는 권한 승인 후에만 동작하며 데스크톱 펫은 기본 꺼짐이다.

관련 논문 1

유사 도구