OpenCodeHub is an open-source, self-hosted alternative to GitHub and GitLab engineered as a modular monolith. It provides stack-first developer workflows (Graphite-style stacked diffs), an automated merge queue with speculative builds, Docker-based CI/CD pipelines, and multi-model AI code reviews out of the box — with zero per-seat licensing fees.

Documentation · CLI Quickstart · Deploy in 5 Minutes · API Reference

✨ Key Differentiators

💻 OpenCodeHub CLI (och)

The official OpenCodeHub CLI (opencodehub-cli) delivers a terminal-first workflow for stacks, code reviews, merge queues, and repository management.

Installation

Install globally using your preferred package manager:

# via npm
npm install -g opencodehub-cli

# via bun
bun add -g opencodehub-cli

# via pnpm
pnpm add -g opencodehub-cli

# via yarn
yarn global add opencodehub-cli

Or run directly without installing:

npx opencodehub-cli --help

1. Authenticate

# Interactive login
och auth login --url https://git.yourcompany.com

# Non-interactive / CI login with Personal Access Token
och auth login --url https://git.yourcompany.com --token och_xxxxxxxxxxxx

# Check health & auth status
och config doctor

2. Stacked PR Workflow

Create and submit Graphite-style stacked branches in seconds:

# Create first stacked branch
och stack create feature/user-auth

# Commit changes, then create dependent branch
git commit -am "feat: implement auth middleware"
och stack create feature/user-profile

# Push all branches in the stack and generate linked PRs automatically
och stack submit

# Visualize your stack topology in terminal
och stack log

# Rebase the whole stack when upstream main updates
och stack sync

3. Interactive Focus Cockpit (och focus)

Launch the terminal dashboard for PRs, reviews, and merge queue operations:

och focus

• Interactive Timeline: Switch branches, view diff stats, and trigger CI runs without leaving the CLI.
• Review Cockpit: Approve, request changes, or trigger AI code reviews inline.
• Queue Controls: Enqueue PRs and monitor speculative build states in realtime.

4. Merge Queue Management

# View active queue status and speculative lanes
och queue list

# Enqueue a PR for automated CI validation and merge
och queue add 42

# Check queue position and build attempts
och queue status 42

🚀 Quickstart & Deployment

Production Stack (Docker Compose)

# 1. Clone the repository
git clone https://github.com/swadhinbiswas/OpencodeHub.git
cd OpenCodeHub

# 2. Configure environment
cp .env.example .env
# Edit .env and set your secrets (JWT_SECRET, SESSION_SECRET, POSTGRES_PASSWORD, REDIS_PASSWORD)

# 3. Launch the container stack
docker compose up -d

# 4. Initialize the admin account
docker compose exec app bun scripts/seed-admin.ts

Open http://localhost:4321 in your browser to start collaborating.

Container Images

Official minimal production images (251 MB) are published on Docker Hub:

🎨 Design System & Theme

OpenCodeHub features a modern developer UI built on Tailwind CSS, Radix UI, and clean GitHub/Linear design principles:

• Adaptive Theming: Native dark and light theme support with zero layout flicker.
• High-Contrast Dark Mode: Pure zinc/slate dark surfaces (#0d1117 / #161b22) paired with crisp emerald status indicators (#238636).
• Responsive Workspace: Full mobile, tablet, and desktop fidelity with integrated keyboard shortcuts.

🏛 Architecture

┌─────────────────────────────────────────────────────────────┐
│                        CLIENTS                               │
│  Browser  │  Git CLI (HTTP/SSH)  │  OpenCodeHub CLI (och)   │
└─────────────────────────────────────────────────────────────┘
                              │
┌─────────────────────────────────────────────────────────────┐
│                    OPENCODEHUB PLATFORM                      │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │  Web UI     │  │  REST API   │  │  GraphQL Endpoint   │  │
│  │ (Astro+React│  │ (175+ routes│  │ (src/pages/api/...) │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │ Git Server  │  │ SSH Server  │  │  Pipeline Runner    │  │
│  │ (HTTP RPC)  │  │ (ssh2 daemon│  │ (Docker Executor)   │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
└─────────────────────────────────────────────────────────────┘
                              │
┌─────────────────────────────────────────────────────────────┐
│              PERSISTENCE & INFRASTRUCTURE                    │
│  PostgreSQL / SQLite / Turso │ Redis (Queues) │ Pluggable S3 │
└─────────────────────────────────────────────────────────────┘

🧪 Development & Testing

# Install dependencies
npm install

# Push database schema
npm run db:push

# Run full test suite (679 unit, integration & contract tests)
npm run test

# Typecheck & verify build
npm run typecheck
npm run build

📄 License

OpenCodeHub is released under the MIT License.