Skip to content

TheCaspianAI/Caspian

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

102 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Caspian

The command center for AI coding agents

Run multiple AI agents in parallel. Each in its own isolated workspace. All from one screen.


Quick Start   ·   Discussions   ·   Contributing



CI   macOS   Linux   Windows   MIT License

The Problem

Running multiple AI coding agents gets messy fast:

  • 5 terminals, 5 agents — endless Cmd+Tab
  • No visibility — what's agent #3 doing?
  • No isolation — agents overwriting each other
  • No persistence — close terminal, lose everything

Your brain becomes the bottleneck. More agents = more chaos.


The Solution

Isolated Workspaces Every agent gets its own git worktree. No conflicts.
Parallel Execution Run multiple agents simultaneously.
Unified Dashboard All agents, one screen. No context switching.
Real-time Monitoring Watch agents work live.
Persistent Sessions Close app. Come back. Everything's there.
Multi-Agent Support Claude Code, Codex, OpenCode or bring your own.

Quick Start

Prerequisites

Dependency Version Install
Bun 1.0+ curl -fsSL https://bun.sh/install | bash
Git 2.20+ Download

Note: You can use any terminal-based AI agent (Claude Code, Codex, Cursor CLI, etc.)

Install & Run

git clone https://github.com/TheCaspianAI/Caspian.git
cd Caspian
bun install
bun run dev

Build

bun run build:mac     # macOS
bun run build:linux   # Linux
bun run build:win     # Windows

How It Works

Add Repo  →  Create Workspace  →  Launch Agent  →  Monitor  →  Review  →  Ship PR

Each workspace is an isolated git worktree. Agents can't step on each other. When you're happy with the changes, create a PR directly from Caspian.


Architecture

Layer Tech Responsibilities
Renderer React 19, TypeScript, Tailwind v4 Dashboard, terminal streaming, diff viewer
IPC tRPC Type-safe communication
Main Electron, Node.js Git orchestration, terminal daemon, SQLite

Tech Stack

Electron React TypeScript Tailwind Bun tRPC SQLite Drizzle


Contributing

PRs welcome! See CONTRIBUTING.md for guidelines.


FAQ

What AI agents does Caspian support?
Any terminal-based agent: Claude Code, Codex CLI, OpenCode, Gemini CLI, etc. If it runs in a terminal, it works.
How is this different from just using tmux?
Caspian provides git worktree isolation (agents can't conflict), a visual dashboard, persistent sessions across restarts, and one-click PR creation. Tmux gives you panes; Caspian gives you a control plane.
Does it work offline?
Yes. Caspian runs entirely locally. Your code never leaves your machine.

License

MIT


GitHub   ·   Issues   ·   Discussions



If Caspian helps you ship faster, give it a ⭐

About

Caspian is a control room for running multiple AI coding agents in parallel

Resources

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages