Gridbash is an open-source terminal orchestrator and multi-pane agent harness developed by Jason Suhari. It is designed to manage, supervise, and coordinate multiple concurrent CLI coding agents across structured terminal grid layouts. In daily use, Gridbash functions as an agent-aware terminal multiplexer and control system. Developers and autonomous manager agents can spawn, inspect, and control multiple sub-agent processes across dedicated panes. It exposes a control API (`gridbash ctl` and `gridbash agent`) that allows agents to programmatically label workspaces, query execution state, and delegate tasks. It includes native support for resuming agent sessions (such as Codex CLI) while preserving critical sandbox configurations and security approval profiles. Gridbash distinguishes itself from standard terminal multiplexers like tmux by integrating agent-specific lifecycle management. It features adaptive CPU throttling to prevent resource contention during multi-agent cold starts and session recoveries, a dedicated status bar backed by output summarizers, and programmatic pane manipulation tailored for multi-agent workflows. Gridbash is available as open-source software distributed via npm and GitHub, with platform support across macOS, Linux, and Windows environments.
Tags: agent harness, ai agent, cli, coding agent, terminal
gridbash ctl. - Adaptive CPU Throttling — Manages process weights and startup sequences during multi-pane batch launches to eliminate CPU spikes. - Profile-Preserving Session Resume — Restores terminated or recovered agent sessions (such as Codex CLI) while retaining sandbox and approval flags. - Built-in Status Summarization — Displays concise agent status updates in the terminal status bar directly from process output summarizers. - Cross-Platform Support — Runs across macOS, Linux, and Windows with native platform terminal integrations.gridbash agent rename and the control API to label worker tasks and monitor task completion status dynamically.Gridbash is built for developers, AI engineers, and automation power users running concurrent or multi-agent CLI workflows in the terminal. It is ideal for teams orchestrating autonomous coding agent swarms that require granular pane control and CPU management, but is unnecessary for developers who only run a single agent in an interactive REPL.
bash npm install -g gridbashbash gridbash Configure your preferred agent profiles (such as Codex CLI or other agent runners) in your local environment or profile configuration.bash # Launch an agent session inside Gridbash gridbash # Rename a pane from inside an agent or script gridbash ctl rename "frontend-worker" # Query running pane status via control CLI gridbash ctl listPart of CLI Coding Agents
Categories: AI Coding Agents, Code Assistants, Developer Tools