clideck

clideck is an open-source agent harness and terminal orchestration tool maintained by rustykuntz on GitHub. It serves as a unified orchestration layer designed to manage, execute, and monitor AI coding agents across various developer workflows. In daily use, clideck coordinates agent sessions via terminal interfaces, plugin integrations, and structured query commands like `clideck ask`. It features built-in transcript recording, stream processing, session reconnect handling, and automated task routing to direct work across supported LLM backends (including Claude-based workflows) and plugins. Unlike standalone coding assistants, clideck functions as a harness that bridges terminal interactions, custom agent skills, and external plugins (such as OpenCode and Pi extensions). It provides terminal replay capabilities, output capture, and session resilience so developers can run automated multi-step coding operations without losing state. clideck is open source and freely available on GitHub. It uses a JavaScript/Node-based modular architecture featuring skills, plugins, and executable binaries with frequent release updates.

Tags: agent harness, ai agent, cli, coding agent, terminal

Visit clideck

Key features

  • Agent session orchestration — Manages persistent agent lifecycles, reconnection states, and background execution in the terminal. - CLI query interface (clideck ask) — Provides commands to query and retrieve structured responses directly from running or background agent sessions. - Autopilot routing & skills — Routes prompts and tasks dynamically through configurable agent skills and workflow triggers. - Terminal replay & stream parsing — Captures, filters, and replays terminal session transcripts while ignoring ANSI escape sequences like OSC 52. - Modular plugin architecture — Includes dedicated integrations for OpenCode plugins, Pi extensions, and Claude session token resumption. - Voice and token management — Supports voice input slots and session resume tokens for seamless context continuation across agent instances.

Use cases

Use Case: Querying and Automating Agent Operations Developers can use clideck ask from scripts or terminal multiplexers to query running agents programmatically, capturing concise answers and agent outputs without manually switching contexts.

Use Case: Orchestrating Custom Skills and Plugins Teams can integrate specialized plugins (like OpenCode or Pi extensions) and register custom skill definitions to let clideck handle complex autopilot routing across varied toolchains.

Use Case: Session Recovery and Terminal Auditability Engineers running long-running AI refactoring sessions can inspect live reconnect indicators, review transcript capture, and replay terminal outputs to trace every change the agent executed.

Who it is for

clideck is built for software engineers, DevOps practitioners, and tool builders who want an orchestration harness to manage multi-agent CLI workflows and terminal sessions. It is less suitable for developers looking for a simple single-file code completion plugin with a GUI setup.

Install guide

Installation Clone the repository and install dependencies using standard Node.js package management: bash git clone https://github.com/rustykuntz/clideck.git cd clideck npm install To link the binary globally: bash npm link

First Run Configure required environment variables (such as your model API keys) and verify the installation: bash export ANTHROPIC_API_KEY="your-api-key" clideck --help

Example Session Start a clideck orchestration session or query an active agent directly via the CLI: bash # Ask an agent to perform a task or answer a repository query clideck ask "Explain the project structure and list available plugin hooks"

Part of CLI Coding Agents

Categories: AI Coding Agents, Code Assistants, Developer Tools

Related CLI agents

  • Claude Squad — Claude Squad is an open-source terminal user interface (TUI) orchestrator and multi-instance session harness for Claude coding agents, developed by…
  • Gridbash — Gridbash is an open-source terminal orchestrator and multi-pane agent harness developed by Jason Suhari. It is designed to manage, supervise,…
  • The Perfect Orchestrator — The Perfect Orchestrator is an open-source orchestration harness and plugin designed for Anthropic's Claude Code CLI. Created by developer daman8271,…
  • Even — Even is an agent-native desktop workspace and orchestration environment developed by Todience, Inc. It integrates a native terminal, an embedded…
  • Repomon — Repomon is an open-source developer harness and repository companion tool created by Ali Hamza Azam. Built with a Rust core…
  • Pi Boss — Pi Boss is an open-source multi-agent orchestration extension developed by skyfallsin for the pi terminal coding agent ecosystem. It provides…
  • AI Tools
  • Categories
  • Industries
  • CLI Coding Agents
  • MCP Servers
  • MCP Categories