ForgeAILab/forge

여러 코딩 에이전트가 서로 충돌하지 않고 하나의 저장소(repo)에서 협업하게 만드세요.

Forge는 각 작업(task)에 고유한 격리된 git worktree를 부여하며, 변경 사항이 main 브랜치에 반영되기 전에 CI 게이트(gate)와 리뷰 단계를 실행합니다. Claude Code, Codex, Gemini, opencode 및 사용자의 자체 쉘 에이전트(shell agents)를 하나의 로컬 우선(local-first) 작업 라이프사이클(lifecycle)을 통해 구동하세요. 단일 바이너리(single binary)로 REST API, MCP 엔드포인트(endpoint), CLI, 웹 UI를 제공합니다. 셀프 호스팅(Self-hosted) 방식이며, MIT 라이선스이고, 클라우드를 사용하지 않습니다.

Quickstart · Why Forge · Docs · Changelog · Contributing

동일한 저장소에 대해 두 개의 코딩 에이전트를 실행하는 것은 디프(diff)를 손실하는 지름길입니다. Forge는 이를 해결합니다. 모든 작업은 각자의 git worktree에서 실행되며, CI 게이트를 통과하고, 머지(merge)되기 전에 리뷰를 기다립니다. 에이전트들은 협업하며, 충돌하지 않습니다.

작업당 하나의 격리된 git worktree— Claude Code, Codex, Gemini가 서로의 작업을 덮어쓰거나 메인 체크아웃(main checkout)을 오염시키지 않고 각각 병렬로 작업할 수 있습니다.
CI를 통한 리뷰 게이트(Review gate)— 작업별로 ci_steps를 정의하세요. 리뷰 러너(review runner)는 단계가 통과될 때까지 머지를 차단합니다. 사람의 승인(Human approval)은 사후 고려 사항이 아닌 명시적인 전환 단계입니다.
구조화된 작업 라이프사이클(Structured task lifecycle)— todo → in_progress → review → merging → done 과정을 거치며, 감사 로그(audit log)와 명시적인 취소 경로를 제공하여 에이전트(및 사람) 간의 인수인계가 명확하게 식별됩니다.
BYO 에이전트(Bring Your Own agent)— Claude Code, Codex, Gemini, opencode 및 범용 쉘 실행기(shell executor)를 위한 퍼스트 클래스 어댑터(first-class adapters)를 제공합니다. 작은 어댑터만 추가하면 자신만의 에이전트를 등록할 수 있습니다.
단일 바이너리로 모든 인터페이스 제공— REST API, MCP JSON-RPC, forge-ctl CLI, 그리고 React 웹 UI가 함께 제공됩니다. 스크립트, 에디터 또는 브라우저를 통해 Forge를 구동하세요.
기본적으로 로컬 우선(Local-first by default)— 단일 바이너리, SQLite, 로컬 포트가 유지되는 루프백 전용(loopback-only) 서버를 사용합니다. 텔레메트리(telemetry)나 SaaS는 없으며, 데이터는 디스크에 그대로 머뭅니다.

브랜치 충돌(branch collisions)이나 공유 트리 편집으로 인해 디프(diff)를 계속 손실하는 개발자(Claude Code + Codex, Codex + Gemini 등 이미 하나 이상의 코딩 에이전트를 실행 중인 경우)
에이전트 워크플로우(agent workflows)를 시도 중인 소규모 엔지니어링 팀으로서, 코드가 main에 반영되기 전 worktree 격리, 감사 추적(audit trails), 리뷰 게이트가 필요한 경우

Builders로서, 또 다른 호스팅된 대시보드가 아닌 AI 코딩 작업을 위한 로컬에서 해킹 가능한(hackable) 컨트롤 플레인(control plane)을 원하는 분들을 위한 도구입니다.

만약 단순히 에디터에 결합된 채팅 UI만을 원한다면, Forge는 귀하를 위한 것이 아닙니다. 대신 Continue나 Cline을 사용해 보세요.

# npm을 통해 즉시 실행 (macOS / Linux)
npx @forgeailab/forge --demo
# Homebrew를 통해 설치 (macOS / Linux)
...

서버 로그에 출력된 management_url을 여세요. 그것으로 끝입니다 — 라벨이 지정된 작업(task)과 가짜 데몬(daemon) 보고서가 포함된 데모 프로젝트가 보일 것입니다. 여기서 다음을 수행할 수 있습니다:

• 실제 작업을 엔드 투 엔드(end-to-end)로 수행 → docs/getting-started.md
• Claude Code / Codex / Gemini 연결 → docs/getting-started.md#agents
• API 직접 호출 → docs/api.md

소스에서 직접 빌드하는 것을 선호하시나요? cargo run -p forge-cli -- --demo

.

개념	설명
Project (프로젝트)	레포지토리(repos), 작업(tasks), 에이전트(agents) 및 워크플로 정의를 그룹화하는 워크스페이스(workspace).
Repo (레포)	작업이 수행되는 로컬 git 체크아웃(checkout)에 대한 포인터.
Task (작업)	상태(state), 선택적 CI 단계 및 감사 로그(audit log)를 가진 에이전트 작업의 단위.
Agent (에이전트)	데몬(daemon)에 바인딩된 등록된 AI 실행기 (Claude Code, Codex, shell, …).
Daemon (데몬)	설치된 CLI를 보고하고 실행을 수행하는 로컬 프로세스.
Worktree (워크트리)	작업당 생성되는 격리된 git 체크아웃으로, done / cancelled 시 정리됨.
Review gate (리뷰 게이트)	review → merging을 차단하는 CI 단계 + 선택적 인간 승인.

Task 상세 — 라이프사이클(lifecycle), 역할 할당(role assignments), CI/리뷰 게이트, 감사 로그 |
Daemon — 호스트에 설치된 CLI(Claude Code, Codex, Gemini, opencode, shell)를 자동 감지 |

더 깊이 알아보기 → docs/architecture.md.

문서	내용
Getting started (시작하기)	설치, 첫 프로젝트, 에이전트, 엔드 투 엔드 작업 가이드.
...

Forge는 퍼블릭 베타(public beta) (0.1.x) 단계에 있습니다. 로컬 우선(local-first) 싱글 유저 제품으로서 엔드 투 엔드로 사용 가능하지만, API, 스키마(schemas) 및 CLI 플래그(flags)는 지원 중단 주기(deprecation cycles) 없이 변경될 수 있습니다. 변경 사항은 CHANGELOG.md에서 확인하세요. 안정적인 1.0 버전은...

워크플로 엔진 (workflow engine), 멀티 유저 스토리 (multi-user story), 그리고 릴리스 아티팩트 (release artifacts) (서명 (signing), SBOMs, Homebrew, Windows 빌드)가 확정되면 출시될 예정입니다.

이슈 (Issues), PR (Pull Requests), 그리고 디자인 논의를 환영합니다. CONTRIBUTING.md으로 시작하여 good first issue 및 help wanted 라벨을 확인하세요. 참여함으로써 귀하는 행동 강령 (Code of Conduct)에 동의하게 됩니다.

취약점은 .github/SECURITY.md에 따라 비공개로 보고해 주세요.

MIT © Forge 기여자들.