sahil87/run-kit

<img src="https://raw.githubusercontent.com/sahil87/run-kit/main/assets/logo.svg" alt="HexoKit logo" width="32" height="32" HexoKit

Part of HexoKit — see all projects there.

Your tmux, in the browser and on your phone. HexoKit is a remote console for the machine you actually work on — every tmux session and pane as a live terminal, in a sidebar, from your desk or your couch. It's the modern, terminal-native answer to the old server web-console: nothing to configure, no database, state read straight from tmux.

What makes it so good right now is what tends to run in those panes: AI coding agents, many at once. rk riff spawns each one in its own git worktree, and the dashboard lets you watch the whole fleet. But HexoKit never wraps the agent — a pane is just a pane. It's equally a build, a REPL, an ssh session, htop. The agent is one of the things you run, not the thing HexoKit is. That's the point: when the agent tooling churns underneath you (and it does, monthly), the terminal layer stays put.

Install

curl -fsSL https://hexokit.com/install | sh

Installs the entire HexoKit toolkit via Homebrew, handling tap trust automatically. HexoKit relies on its sibling tools (wt for the riff worktree flow), so the full-toolkit install is the supported path. The formula also installs rk as a fully interchangeable short alias of run-kit — every command here works with either.

Requires tmux ≥ 3.4 (checked at runtime; rk doctor reports your version). See the install & access guide for prerequisites, upgrades, and troubleshooting.

Quick start

Three commands from install to a guided tour:

rk daemon start                 # start the dashboard daemon on :3000
open http://localhost:3000      # open the dashboard (xdg-open on Linux)

# in a tmux session (tmux new -s work if you aren't in one):
rk tutorial                     # guided first run — an agent walks you through the product, act by act

Then spawn your first real agent workspace — a git worktree, a tmux window inside it, your agent launched:

rk riff                         # spawn an agent workspace (--skill /name picks the slash-command)

The new workspace appears in the sidebar; click into it to drive the agent — or any command — from the dashboard, on any device.

Two optional extras:

• shll setup agent (once per machine; run automatically at the end of a toolkit install) makes agent panes report live busy/waiting/idle state in the dashboard — see Agent state.
• The desktop app is an alternative front door on macOS and Linux: rk desktop install, then one Start & connect click replaces the daemon start + open steps.

To upgrade later, rk update pulls the latest version via Homebrew and restarts the daemon. Coming from the old rk Homebrew formula, or something failing? See the install & access guide and rk doctor.

Why HexoKit?