Skip to main content
CliDeck is a local terminal dashboard that lets you run, monitor, and manage multiple CLI coding agents from a single browser tab. Think of it as Slack for your terminal — 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 the things you’ve been missing: live status indicators, message previews, browser notifications, session resume, and project grouping.

Why CliDeck

Running multiple AI agents across different terminal windows gets chaotic fast. You lose track of which agent is working, which one finished, and what it said. CliDeck solves this with a simple idea: put all your agents in one place and show you what’s happening.
  • Status at a glance — Green dot means working, “zzZ” means idle. No more checking each terminal window.
  • Live previews — See the latest message from each agent right in the sidebar, without switching tabs.
  • Notifications — Get a browser notification (with optional sound) when an agent finishes working. Walk away from your computer 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.
  • 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 — Extend CliDeck with plugins that can observe output, transform input, add toolbar buttons, and more. CliDeck ships with two built-in plugins (Trim Clip and Voice Input) and you can build your own.

Supported Agents

CliDeck works out of the box with four CLI agents: You can also add any CLI tool as a custom agent or a plain shell session.

How It Works

CliDeck runs a lightweight local server on your machine. Each agent session gets a real PTY (pseudo-terminal), rendered in your browser using xterm.js. The agent doesn’t know CliDeck exists — it thinks it’s running in a normal terminal. The key feature is telemetry integration. Each supported agent emits OpenTelemetry logs that CliDeck receives locally. This is how CliDeck knows when an agent is working, idle, or waiting for input — without parsing terminal output or intercepting your commands.
All data stays on your machine. CliDeck doesn’t send anything to external servers. The telemetry flows from the agent to CliDeck over localhost.

Quick Start

Get running in under a minute:
npm install -g clideck
clideck
Then open http://localhost:4000 in your browser.

Full setup guide

Detailed installation instructions and first session walkthrough.