Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.clideck.dev/llms.txt

Use this file to discover all available pages before exploring further.

CliDeck is a local terminal dashboard for running multiple CLI coding agents from one browser tab. It’s a coordination layer over your existing tools, not a replacement. You keep using Claude Code, Codex, Gemini CLI, and OpenCode exactly as you do today. CliDeck wraps each agent in its own terminal panel and adds: live status, message previews, notifications, session resume, roles, project grouping, and multi-agent workflow routing.

​
Why CliDeck

You run multiple AI agents in separate terminals. You lose track of which one is working, which one finished, and what it said. CliDeck puts them all in one place and shows you what’s happening.
  • Status at a glance — Green dot means working, “zzZ” means idle.
  • Live previews — Latest message from each agent in the sidebar.
  • Notifications — Browser notification (with optional sound) when an agent finishes. Walk away and come back when something needs your attention.
  • Session resume — Shut down CliDeck, come back later, and resume your agent sessions right where you left off.
  • Mobile remote — Check on your agents from your phone. QR scan to pair, see who’s working, send messages, answer menus. E2E encrypted.
  • Roles — Define reusable agent identities (Programmer, Reviewer, PM) and assign them when creating sessions. Instructions are injected into the agent at startup.
  • Autopilot — Project-level workflow routing. Watches your role-assigned agents, waits for idle, forwards output to the next specialist. 30–50 tokens per routing decision.
  • Zero interference — CliDeck doesn’t sit between you and the agent. The terminal is a real terminal. Your keystrokes go directly to the agent, and the agent’s output comes directly to you.
  • Plugins — Server + client API with hooks for input, output, status, transcript, and menus. Ships with Trim Clip, Voice Input, and Autopilot. Same API the bundled plugins use.

​
Supported Agents

CliDeck works out of the box with four CLI agents:

Claude Code

Anthropic’s CLI agent. Telemetry works automatically — no setup needed.

Codex

OpenAI’s CLI agent. One-click telemetry setup from the CliDeck UI.

Gemini CLI

Google’s CLI agent. One-click telemetry setup from the CliDeck UI.

OpenCode

Run any model (local or cloud) through OpenCode’s TUI. Uses a plugin bridge for real-time status.
You can also add any CLI tool as a custom agent or a plain shell session.

​
How It Works

CliDeck runs a local Node.js server. Each agent session gets a real PTY (pseudo-terminal), rendered in the browser via xterm.js. The agent doesn’t know CliDeck exists — it thinks it’s in a normal terminal. Status detection works through telemetry. Each supported agent emits OpenTelemetry logs that CliDeck receives on localhost. This is how it knows when an agent is working, idle, or waiting for input — without parsing terminal output or intercepting commands. Autopilot routes existing agent output between agents verbatim — it chooses the next handoff, but never rewrites or summarizes the content.
All data stays on your machine. Telemetry flows from the agent to CliDeck over localhost. Autopilot’s LLM calls go directly to whichever provider you configure. CliDeck has no servers.

​
Quick Start

Install and run: 
npm install -g clideck
clideck
Then open http://localhost:4000 in your browser.

Full setup guide

Detailed installation instructions and first session walkthrough.