Agent Deck

Agent Deck is an open-source agent harness and terminal-based fleet orchestrator created by Ashesh Goplani. Implemented in Go, it provides session lifecycle management, sub-agent orchestration, and persistent execution tracking for developer agent workflows. In daily use, Agent Deck operates as a CLI tool that launches and monitors agent sessions—such as Claude-based coding agents and autonomous task workers. It organizes concurrent runs by working directory or Git worktree group, tracking execution progress through completion ledgers, crash-safe message inboxes, and sentinel tokens to notify parent processes when tasks conclude. Agent Deck differentiates itself from basic agent wrappers by focusing on fleet fan-out and distributed execution. Rather than running one isolated prompt session, it lets parent agents launch independent child sessions, manage multi-worktree parallel tasks, wake parent tasks on child completion, and synchronize completion statuses across local and remote environments. Agent Deck is open source on GitHub and developed as a native Go binary with active tooling and continuous integration gates.

Tags: cli, coding agent, developer tools, OpenSource, terminal

Visit Agent Deck

Key features

  • Fleet Fan-Out — Launch independent parented child agent sessions from within an active session and monitor their execution state via dedicated fleet commands. - Completion Ledger — Maintain a persistent, non-destructive store of interactive and task-worker completions to reliably signal parent processes. - Completion Sentinels (--assert-done) — Append detectable completion sentinels to agent workflows (such as Claude runs) to identify when background tasks finish. - Worktree and Group Inheritance — Automatically bind and inherit parent groups across Git worktrees to maintain context across distributed tasks. - Crash-Safe Inbox Delivery — Preserve error transitions and message replay guarantees across session restarts and unowned discovery events. - Remote Session Coordination — Pull and monitor cross-machine task completions using dedicated remote orchestration subcommands.

Use cases

Use Case: Parallel Multi-Agent Task Fan-Out A developer or top-level agent breaks a complex refactoring task into multiple independent modules, launching parented child sessions in parallel while the parent monitors completion ledgers to resume only when all workers finish.

Use Case: Worktree-Isolated Feature Development A team orchestrates several concurrent tasks across separate Git worktrees, using automatic group inheritance to ensure each agent's runtime context and completions stay organized by branch.

Use Case: Cross-Machine Remote Agent Monitoring A developer dispatches long-running compute or evaluation tasks on a remote server and uses remote CLI commands to pull completions and sync progress directly into their local terminal.

Who it is for

Agent Deck is built for software engineers, platform developers, and advanced AI agent builders who need to orchestrate multiple concurrent or parent-child terminal agents across Git worktrees and remote environments. It is less suited for developers looking for a simple single-prompt conversational TUI or GUI-driven chat client.

Install guide

Installation Install Agent Deck using Go (requires Go 1.25+): bash go install github.com/asheshgoplani/agent-deck@latest Alternatively, clone and build the binary from source: bash git clone https://github.com/asheshgoplani/agent-deck.git cd agent-deck go build -o agent-deck .

First Run Ensure your agent environment (such as Claude API keys or plugin configurations) is set up, then check available commands: bash agent-deck --help

Example Session Launch a parented child agent with group inheritance and completion sentinels: bash # Launch an agent session in a Git worktree inheriting parent group context agent-deck launch --inherit-group --assert-done # Check the status of active child sessions agent-deck session children # Pull completions across remote instances agent-deck remote

Part of CLI Coding Agents

Categories: AI Coding Agents, Code Assistants, Developer Tools

Related CLI agents

  • Claude Code Tools — Claude Code Tools (cctools) is an open-source orchestration harness and plugin distribution toolkit developed by Prasad Chalasani (pchalasani). It is…
  • agenttrace — Agenttrace is an open-source agent harness and tracing orchestrator developed by luoyuctl on GitHub. It is designed to capture, monitor,…
  • Contextzip — Contextzip is an open-source command-line optimization harness and utility developed by jee599, built in Rust to manage and compress context…
  • claude-cmd — claude-cmd is an open-source command-line interface and workflow harness for Anthropic's Claude, developed by independent open-source developer kiliczsh. The tool…
  • Fireconnect — Fireconnect is an open-source CLI orchestration tool developed by Fireworks AI (fw-ai) designed to route various AI coding agents and…
  • postmortemthis — postmortemthis is an open-source command-line agent harness and orchestration tool developed by Softeria. It orchestrates specialized CLI coding agents and…
  • AI Tools
  • Categories
  • Industries
  • CLI Coding Agents
  • MCP Servers
  • MCP Categories