A Phoenix LiveView web UI for managing Claude Code sessions. Create, monitor, and interact with multiple Claude Code CLI sessions from your browser.

The fastest way to run OrcaHub — no Elixir or PostgreSQL installation needed.

1. Clone and configure:

   git clone https://github.com/zingbretsen/orca_hub.git
   cd orca_hub
   cp .env.example .env

   Edit .env to add API keys for title generation or other optional features (see Environment Variables).

2. Start:

   docker compose up -d

   This builds the app, starts PostgreSQL, runs migrations, and serves OrcaHub at localhost:4000.

3. Authenticate Claude Code (one-time):

   docker compose exec app claude login

   Credentials are stored in a Docker volume and persist across restarts.

4. Mount your project directories by editing docker-compose.yml:

   volumes:
     - claude_credentials:/home/orca/.claude
     - /home/user/projects/my-app:/home/orca/projects/my-app

   Then restart with docker compose up -d. When creating sessions in OrcaHub, set the working directory to /home/orca/projects/my-app.

   Note: Set PORT in your .env to change the default port.

If you prefer to run OrcaHub outside Docker (for development or customization):

• Elixir & Erlang — Install via asdf or see the official Elixir installation guide. OrcaHub requires Elixir ~> 1.15.
• PostgreSQL — Run via Docker (docker compose up db -d) or install locally.
• Claude Code CLI — Install the Claude Code CLI and authenticate it. OrcaHub spawns Claude sessions via the CLI.

1. Clone the repository:

   git clone https://github.com/zingbretsen/orca_hub.git

2. Configure environment variables:

   cd orca_hub
   cp .env.example .env

   Edit .env if your database credentials differ from the defaults. Optionally add a TITLE_GEN_OPENAI_API_KEY or DataRobot credentials for automatic session title generation.

3. Start PostgreSQL (if using Docker):

   docker compose up db -d

4. Install dependencies and set up the database:

   mix setup

   This fetches dependencies, creates the database, runs migrations, and builds assets.

5. Start the server:

   mix phx.server

   Visit localhost:4000.

• Logs: tail -f log/dev.log
• Live Dashboard: localhost:4000/dev/dashboard
• Tests: mix test
• Linting: mix credo

• Phoenix Framework
• Phoenix LiveView
• Phoenix Deployment Guides