Codebuff — composable multi-agent coding assistant
Codebuff는 CLI, SDK, 웹 API를 함께 가진 TypeScript/Bun 모노레포이고, 특화 에이전트들을 조합해 코드베이스를 읽고 수정하는 쪽에 초점을 둔다. Freebuff는 같은 기반의 무료 광고형 버전이다.
한줄 요약
Codebuff는 Claude Code/Codex 계열과 같은 코딩 에이전트 범주에 있지만, 단일 채팅 CLI보다 에이전트 프레임워크 + SDK + 웹 API + 커스텀 agent template 쪽이 더 강하다. README 기준으로는 file picker → planner → editor → reviewer 같은 분업형 에이전트를 묶어 작업을 수행한다.
핵심 포인트
- 멀티 에이전트 오케스트레이션: 파일 탐색, 계획, 편집, 검증을 분리한 specialized agent 구조
- 프레임워크 성격:
.agents/에 prompt/programmatic agents를 두고,handleStepsgenerator로 절차형 워크플로우를 정의 - 세 가지 실행면:
cli/TUI,sdk/런타임 연동,web/Next.js API/모델 게이트웨이 - 다중 모델 지원: Anthropic/OpenAI/Gemini 등 여러 LLM provider를 붙이는 구조
- Freebuff 분리: 무료·광고형 경로를 별도 제품으로 둬 진입 장벽을 낮춤
- Bun 모노레포: workspaces 기반 TypeScript 저장소로 CLI/SDK/web/agents/common/packages가 분리됨
아키텍처 메모
README와 docs/architecture.md를 합치면 흐름이 꽤 선명하다.
- 사용자가 CLI에 자연어 작업을 입력한다.
- SDK가 세션과 로컬 툴 실행을 오케스트레이션한다.
- agent-runtime이 LLM 호출과 tool call 루프를 돌린다.
- 웹 서버가 모델 라우팅과 인증, 크레딧/구독 체크를 담당한다.
- 결과가 다시 CLI로 스트리밍된다.
즉, Codebuff는 에이전트 실행 엔진을 SDK와 웹 백엔드로 분리한 제품형 하네스에 가깝다. 단순히 프롬프트 몇 개로 끝나는 도구가 아니라, 세션·툴·서브에이전트·모델 라우팅을 함께 관리한다.
Freebuff
Freebuff는 Codebuff의 무료 버전이다.
- 구독 없이 시작 가능
- 광고로 운영되는 free tier
- ChatGPT 연결 옵션과 built-in web research/browser use를 내세움
- 설치/진입 장벽을 낮춘 대중형 경로
왜 의미가 있나
Codebuff는 다음 축으로 볼 만하다.
- Claude Code 대체재라기보다, 코딩 에이전트를 제품화하는 운영면
- 커스텀 agents를 만들고 재사용하는 구조가 명확해서, 단순 IDE 보조보다 워크플로우 프레임워크에 가깝다
- Freebuff로 진입층을 열어두면서, 상위에는 SDK와 웹 API를 두는 제품 분리가 깔끔하다
- 멀티 에이전트 분업 구조는 대규모 저장소, 리뷰 자동화, 반복 작업에 잘 맞는다
주의할 점
- README의 벤치마크 수치(예: Claude Code 대비 61% vs 53%)는 저자 측 주장으로 읽는 편이 안전하다.
- 실제 효용은 에이전트 템플릿 작성 품질, 모델 선택, 그리고 웹/SDK 쪽 운영 안정성에 크게 좌우될 가능성이 크다.
- monorepo가 넓어서, 도입 전에 CLI·SDK·web의 역할 분리를 먼저 이해하는 편이 낫다.