CodeForge is a backend orchestrator for AI-powered code work over git repositories. A session is a stateful work unit over a repo — it clones, runs an AI CLI (Claude Code, Codex, Cursor), streams progress via SSE, and supports multi-turn follow-ups, code review, PR creation, and webhook-triggered PR reviews. A React web UI is included.
Two modes: Server (queue + workers + API + UI) or CI Action (self-contained GitHub Action / GitLab CI step for automated PR review).
docker pull ghcr.io/freema/codeforge:latestA ready-to-use compose file is at deployments/docker-compose.production.yaml. For development:
# Requires Docker + Task runner (https://taskfile.dev)
task dev| Document | Description |
|---|---|
| API Reference | Endpoints, request/response, session types, webhooks |
| Architecture | System design, Redis schema, session lifecycle, streaming |
| Code Review | Session review, PR review, webhook-triggered reviews |
| Configuration | Environment variables, YAML config, all options |
| Deployment | Docker, Kubernetes, monitoring |
| Development | Dev setup, testing, project structure, conventions |
| Manual E2E Testing | Manual lifecycle tests against real repos (Claude + Codex) |
| CI Action | GitHub Action / GitLab CI setup, inputs, session types |
MIT | Tomas Grasl — tomasgrasl.cz