# clideck A local workspace for CLI agents. Run Claude Code, Codex, Gemini CLI, OpenCode, Pi, and shell sessions in one browser window. Group them into projects, follow their progress, and pick up conversations where you left off. Each session is the agent's actual terminal, with its own tools, configuration, and account. Agents can open their work directly in CliDeck for you to review as they go. ![CliDeck's terminal workspace with three projects and six agent sessions](public/clideck-workspace.png) *Projects and sessions on the left; the selected agent's terminal on the right.* ## Quick start Requires **Node.js 22.12+** and an installed agent CLI. ```sh npm install -g clideck@2 clideck ``` Open **http://127.0.0.1:4000**, create a project, and add sessions. Mix providers as needed. You can also run `npx clideck@2`. ## Working with sessions The interface works like a WhatsApp conversation list: message previews, unread counts, and activity times let you follow many sessions while working in one. - **Projects.** Group sessions by working folder; drag them between projects. - **Live status.** See who is working, idle, or needs your attention. Browser and sound notifications let you know when work finishes. - **Resume and history.** Reopen saved sessions, read earlier conversations, and see when stopped sessions were last used. Back up your setup and restore selected settings, projects or sessions. - **Search.** Find sessions and search their conversation text. Conversation History searches the full saved conversation with highlighted matches, and offers Jump to latest when new messages arrive without moving your reading position. Ctrl/Cmd+F in the terminal searches retained scrollback, with highlights that stay visible as you scroll. Filter to unread sessions when catching up. - **Task Manager.** See running processes, CPU and memory use, grouped by project and agent. Open the bar-chart button beside Plugins. Filter, expand child processes, and stop a selected job after confirmation. It refreshes only while open and visible; available on macOS and Linux. - **Saved prompts.** Type `//` to reuse a prompt. `{{session_name}}` and `{{project_name}}` fill in the current context. - **Controls.** Light and dark themes and configurable shortcuts. ## See what agents produce Agents can create reports, pages, images, and other artifacts and automatically open them in CliDeck as part of their work. Results appear in tabs beside the terminal, ready for you to inspect and give feedback. Supported previews include: - Markdown, plain text, logs, JSON, CSV tables, HTML, and PDFs. - Images (PNG, JPEG, GIF, WebP) and video (MP4, WebM). - Mermaid diagrams, diffs, charts, and test results. Agents open these with `clideck show`: ```sh clideck show report.md clideck show demo.html clideck show walkthrough.mp4 ``` They can update the same preview as they revise their work. You can also drop files onto the tab strip yourself. ![A Markdown report open in a CliDeck preview tab beside its terminal tab](public/clideck-output.png) ## Plugins - **Git Changes** — inspect edits, branches, and worktree comparisons. - **Supertonic Voice** — listen to replies or selected text with twelve local voices and quick previews. Automatic reading is enabled per session and waits until you open that session. Tables, code blocks and diagrams get a short spoken cue. The speech model downloads on first use. - **Emoji** — emoji support in the terminal. - **Smart Dictation** — optional voice input for prompts. You can also build plugins with the [plugin SDK](PLUGIN-SDK.md). ## Work as a team **CliDeck Ask** lets agents send requests to other sessions and receive their replies, including across providers. You set the direction and review the results. In an FPS project, you flag enemy voices that don't fit. The character programmer chooses the SFX agent from the team, asks for replacements, and brings the update back for you to try. In a LoRA project, you flag poor results in darker scenes. The training manager asks the dataset agent for better examples, retrains, and opens the comparison images in CliDeck for your review. Type `@@` to find sessions such as `@game/sound`. Agents find teammates with `clideck agents` and contact them with `clideck ask`. While you type or paste in a terminal, incoming asks and steering messages are refused with a retry message. They become available after four seconds without input. This protects active typing; an unfinished draft is not protected after that pause. Nothing is queued for automatic delivery. ![An FPS team with map, SFX, visual assets, story, QA, and player agents. Your character programmer chooses SFX for the voice request; SFX replies to the programmer, who brings the update back to you.](public/clideck-teamwork.png) ## Local setup ```sh clideck --port 4200 clideck --data-dir /path/to/clideck-data clideck --help ``` `CLIDECK_PORT` or `PORT` also sets the port. CliDeck binds to localhost and stores its data in `~/.clideck-next` by default. Agent CLIs use their own network connections. For development: `npm ci`, `npm test`, then `npm start`. ## Coming from v1 The latest v2 imports legacy sessions, projects, and saved prompts automatically. Read [the upgrade notes](UPGRADING.md) before updating; see [session backup and recovery](SESSION-BACKUP.md) for restoring saved work. Autopilot was removed because agents already have sub-agents; mobile control was removed because harnesses provide their own remote access. ## License [MIT](LICENSE)