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: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.
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:Full setup guide
Detailed installation instructions and first session walkthrough.