run-kit is an open-source tmux orchestrator and remote management console developed by Sahil Ahuja as part of the shll.ai toolkit. It operates as an agent-agnostic harness, exposing active tmux sessions and panes through a browser-based dashboard accessible from a local workstation or mobile devices over networks like Tailscale. In daily use, run-kit provides terminal multiplexing workflows specifically suited for parallel development. The `run-kit riff` command provisions isolated agent workspaces across distinct Git worktrees (integrating with sibling tool `wt`), while `run-kit serve` launches a live web interface to view session outputs, host metrics, and pane states. Because it connects directly to tmux without wrapping application processes, run-kit is completely model- and agent-agnostic—equally supporting Claude Code, Aider, custom shell scripts, REPLs, and local development servers. What distinguishes run-kit from agent harnesses that wrap LLM APIs is its pure terminal multiplexer foundation. Rather than binding to a single agent protocol or proprietary execution loop, run-kit treats all AI coding agents as standard shell processes. This design ensures that agent orchestration remains durable even as underlying AI tools and CLI agents evolve. run-kit is free, open source under the MIT license, and distributed as a component of the broader shll terminal ecosystem.
Tags: agent harness, ai agent, cli, developer tools, terminal
run-kit serve, optimized for remote inspection over Tailscale. - Worktree workspace generation — Spawns parallel coding agent sessions into isolated Git worktrees using run-kit riff (integrated with wt). - shll ecosystem compatibility — Integrates seamlessly with companion tools such as tu for session cost tracking and wt for Git branch isolation. - Status and notification hooks — Provides status indicators and alerts to track agent progress and pane state transitions.run-kit riff, each agent runs inside an independent Git worktree, allowing the developer to supervise multiple tasks simultaneously from the run-kit sidebar.run-kit is designed for command-line developers who rely on tmux and want remote or parallel monitoring for CLI-based AI coding agents across Git worktrees. It is not suitable for developers seeking a standalone desktop IDE or an agent harness that requires a proprietary LLM API client wrapper.
bash curl -fsSL https://shll.ai/install | shtmux and git are installed on your path, then start the web dashboard: bash run-kit serve Navigate to the local URL displayed in the terminal output (or via your Tailscale address) to access the console.riff: bash run-kit riff feature-refactor Switch to the dashboard running under run-kit serve to monitor the new worktree pane alongside other active tmux sessions.Part of CLI Coding Agents
Categories: AI Coding Agents, Developer Tools, Productivity