<p align="center">
  <img src="https://colana.ai/icon.svg" width="80" height="80" alt="co:lana — multi-agent command center for AI coding agents">
</p>

<h1 align="center">co:lana</h1>
<p align="center"><strong>Agent-First. Multiplied.</strong></p>
<p align="center">
  Run Claude Code, Codex CLI, Copilot CLI, Cursor Agent, Antigravity CLI & Aider side-by-side with split terminals, session resume, and remote sharing.
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/colana"><img src="https://img.shields.io/npm/v/colana.svg" alt="npm version"></a>
  <a href="https://www.npmjs.com/package/colana"><img src="https://img.shields.io/npm/dm/colana.svg" alt="npm downloads"></a>
  <img src="https://img.shields.io/node/v/colana.svg" alt="Node.js version">
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-proprietary-blue.svg" alt="License"></a>
</p>

---

### Free During Beta — Full Access, Zero Limits

Everything is unlocked. Unlimited agents. All 8 providers. No session caps. Free while we build toward stable. Beta supporters get **3 months of Pro free** at launch.

[Send Feedback](https://feedback.colana.ai) · [Feature Requests](https://feedback.colana.ai/feature-requests) · [Report Bugs](https://feedback.colana.ai/bug-reports)

---

Run Claude Code, Codex CLI, Antigravity CLI, Copilot CLI, Cursor, and Aider side-by-side. Monitor output, manage sessions, track costs, review diffs, and share results — all from a single browser tab.

<!-- Screenshot placeholder: add a screenshot or GIF of the dashboard here -->

## Quick Start

```bash
npm install -g colana    # Install globally
colana                   # Start the dashboard
```

The dashboard opens in your browser at `http://localhost:9876`. On first run, a setup wizard walks you through installing and authenticating your preferred AI agents.

## Supported Providers

| Provider | Auth | Resume |
|----------|------|--------|
| **Claude Code** | Anthropic subscription or API key | Yes |
| **Codex CLI** | OpenAI API key | Yes |
| **Gemini CLI** _(retired)_ | Paid API key / Vertex only — Google ended the free CLI | Yes |
| **Copilot CLI** | GitHub Copilot subscription | Yes |
| **Aider** | LLM API key (OpenAI, Anthropic, etc.) | Yes |
| **OpenClaw** | User-configured model keys | — |
| **Cursor Agent** | Cursor subscription (no free tier) | — |
| **Antigravity CLI** | Free Google account (Antigravity sign-in) | — |

You need at least one provider installed. **Antigravity CLI** is recommended for quick start — works with any Google account. The setup wizard detects and installs missing providers automatically.

## Features

### Agent Orchestration
- **Multi-provider dashboard** — run and observe agents across different projects from one screen
- **Interactive terminals** — full terminal emulation for all providers
- **Standalone terminals** — raw shell sessions with no agent, project-scoped and reopenable
- **Real-time streaming** — instant terminal output, no polling
- **Split-pane view** — monitor multiple agents side-by-side with smart project picker and project name headers
- **Pinned Views** — save split-pane layouts, auto-name from context, rename, restore on reload
- **View Mode** — smooth dashboard/single/split transitions with keyboard shortcuts and cross-fade animations
- **Pop-out windows** — focus on one agent or drag it to a second monitor
- **Safe Parallel Mode** — automatic git worktree isolation when multiple agents work on the same project
- **co:cktail profiles** — save an agent, a model and the credentials it should use, then launch that setup from any project ([docs](docs/cocktail.md))

### Session Management
- **Universal resume** — resume sessions for all providers with native support
- **Session history** — search across all projects by title, project, or conversation content
- **Git checkpoints** — auto-capture state on session start, one-click restore, per-file accept/reject
- **Git diff preview** — review file changes with "Open in Editor" integration
- **Auto-resume** — automatically resume interrupted sessions on server restart
- **Session protection** — auto-commit dirty worktree files at every boundary, zero work loss

### Remote Access + Share
- **Remote sharing** — share session outputs (reports, files, previews) via public URLs on remote.colana.ai
- **MCP tool auto-injection** — `colana_create_share` MCP tool available in all coding agents automatically
- **Ed25519 enrollment** — secure relay tunnel with challenge-response authentication

### Personal Agent
- **Always-on companion** — header strip, notification dropdown, and slide-in panel
- **Chat and terminal modes** — stream responses or use the full terminal
- **Proactive notifications** — alerts with category icons and deep links
- **Integration Hub** — connect 17 tools (GitHub, Google Workspace, Slack, Notion, and more)
- **Model switching** — change the AI model from Settings

### Productivity
- **Command palette** — `Ctrl+K` fuzzy search with view mode entries
- **Task templates** — save and reuse common prompts
- **Clipboard snippets** — quick-access code snippets with search
- **Cost tracking** — per-project token and cost tracking
- **Context Sync** — automatic multi-agent project context sharing
- **Project Environment** — define credentials, MCP tools, and context once, Colana resolves per-agent format at spawn

## Pricing

| | Free | Pro |
|---|---|---|
| **Price** | $0 forever | $9/mo or $79/yr |
| **Concurrent sessions** | 2 | Unlimited |
| **All features** | Yes | Yes |
| **All 8 providers** | Yes | Yes |

No trial. No expiry. Free tier is the full product — only concurrent session count is gated.

Payments handled by [Polar.sh](https://polar.sh) (Merchant of Record).

## System Requirements

- **Node.js** 20.0.0 or later
- **OS:** Linux, macOS, or Windows (WSL2 recommended)
- **Browser:** Chrome or Edge (desktop)

## CLI

```bash
colana                   # Start the dashboard
colana --version         # Show version
colana doctor            # Check system health
colana service install   # Auto-start on login
```

## Keyboard Shortcuts

| Shortcut | Action |
|----------|--------|
| `Ctrl+K` | Command palette |
| `Ctrl+B` | Toggle sidebar |
| `` Ctrl+` `` | Personal Agent panel |
| `Ctrl+N` | Focus next pane (split view) |
| `Ctrl+W` | Close active pane |
| `Ctrl+Shift+S` | Toggle split view |
| `F11` | Fullscreen |

## FAQ

**Do I need API keys for all providers?**
No. Install only the ones you use. Antigravity CLI works with just a Google account.

**Does co:lana send my code anywhere?**
No. Everything runs locally on your machine. Your code never leaves your filesystem.

**Can I use co:lana without paying?**
Yes. Free tier is the full product with no expiry. The only limit is 2 concurrent sessions.

**Can I share agent outputs with my team?**
Yes. Remote Access + Share lets you publish session outputs via public URLs on remote.colana.ai — no port forwarding needed.

**What happens if the server crashes?**
Sessions are persisted and auto-resume on restart. Pinned Views and split-pane layouts also survive restarts.

**Does it work on Windows?**
Yes, via WSL2 (recommended). Native Windows is also supported.

**How do I update?**
co:lana checks for updates automatically and shows an in-app banner, or run `npm update -g colana`.

**Where is my data stored?**
Locally in the `data/` directory — database, encrypted API keys, and logs.

## Support

- **Website** — [colana.ai](https://colana.ai)
- **Email** — [hello@colana.ai](mailto:hello@colana.ai)
- **Security** — [hello@colana.ai](mailto:hello@colana.ai)

## License

Proprietary. See [LICENSE](LICENSE) for terms.

Copyright (c) 2025-2026 Colana. All rights reserved.
