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 live, and keeps the workspace around for follow-ups, review, and PR creation. 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).
- Multi-turn sessions with native conversation resume (
claude --resume), so follow-ups keep full context - Live stream of tool calls, thinking, plan progress, and per-turn token/dollar cost (SSE)
- Human-in-the-loop: inspect the actual diff in the UI before a PR is ever opened; PRs only on explicit action
- Code review built in: review a session's changes, or let GitHub/GitLab webhooks trigger PR reviews automatically
- Session types for every job: code, plan, whole-repo review, PR review, and knowledge sessions that keep
.codeforge/docs fresh - Blueprints: reusable session templates with parameters, runnable on demand or on a schedule, with built-ins like the Sentry fixer and repo review
- Schedules: recurring cron sessions with run history, overlap guard, and failure notifications, including scheduled repo reviews and knowledge updates
- Cost & usage tracking per session and per tenant, with quotas and a key pool (subscription mode)
- Multi-CLI (Claude Code, Codex, Cursor) selectable per session, plus MCP tool integration
- Ops-friendly: Redis queue with crash-safe recovery, Prometheus metrics, Slack/Discord/Teams notifications
| Session with live stream, cost & diff | Recurring schedules |
|---|---|
 |
 |
| New session | Session list |
|---|---|
 |
 |
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 |
| Session Types | code, plan, review, pr_review, knowledge: behavior, output contracts, scheduling |
| Blueprints | Named session templates: parameters, built-in library, run API, scheduling |
| 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