Commands
run-kitrun-kit — tmux session manager with web UI
usage
run-kit [flags]run-kit [command]
flags
| flag | type | description | copy |
|---|---|---|---|
--quiet | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit [flags]
run-kit [command]
Available Commands:
agent Agent instrumentation (state hooks setup and reporting)
code Run VS Code commands in the code lens editor from the shell
code-server Manage the rk-owned code-server install (the /code lens editor)
completion Generate the autocompletion script for the specified shell
daemon Manage the background run-kit daemon (tmux-managed run-kit serve)
desktop Install and update the Run Kit desktop app (macOS)
doctor Check runtime dependencies
help Help about any command
mux Tmux substrate operations (server create, messaging, pane capture/kill/process, pane enumeration, janitor, recovery, config scaffold, tmux guard)
notify Send a Web Push notification to subscribed devices
present Show a file, directory, port, or URL to the user as a web tile
remote Use SSH-only machines as run-kit hosts (bootstrap, tunnel, connect)
riff Create a worktree, tmux window, and Claude Code session
role Mark or unmark the current window as the server's operator
serve Start the HTTP server (foreground)
skill Print run-kit's agent skill bundle (static usage briefing)
status Show tmux session summary
tab Drive a tab's UI state — layout, web tabs, code root — from the shell
update Update the run-kit CLI and desktop app to the latest version
url Print the run-kit server URL (env → tmux option → default)
Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
Use "run-kit [command] --help" for more information about a command.
run-kit agentAgent instrumentation (state hooks setup and reporting)
usage
run-kit agent [command]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit agent [command]
Available Commands:
hook Report an agent's lifecycle state to run-kit (invoked by installed hooks)
setup Install agent-harness hooks that report agent state to run-kit
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
Use "run-kit agent [command] --help" for more information about a command.
run-kit agent hookReport an agent's lifecycle state to run-kit (invoked by installed hooks)
usage
run-kit agent hook <state> [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--agent | string | Agent harness whose comm literal drives pid resolution (v1: claude) (default "claude") | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit agent hook <state> [flags]
Flags:
--agent string Agent harness whose comm literal drives pid resolution (v1: claude) (default "claude")
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit agent setupInstall agent-harness hooks that report agent state to run-kit
usage
run-kit agent setup [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--dry-run | Show the diff and write nothing (wins over --yes) | ||
--uninstall | Remove the rk-owned hook entries instead of installing them | ||
-y, --yes | Write without prompting (non-interactive consent) | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit agent setup [flags]
Flags:
--dry-run Show the diff and write nothing (wins over --yes)
--uninstall Remove the rk-owned hook entries instead of installing them
-y, --yes Write without prompting (non-interactive consent)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit codeRun VS Code commands in the code lens editor from the shell
usage
run-kit code [command]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit code [command]
Available Commands:
commands List the command ids a code-bridge host can execute
exec Execute a VS Code command in a code-bridge host
hosts List live code-bridge hosts
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
Use "run-kit code [command] --help" for more information about a command.
run-kit code commandsList the command ids a code-bridge host can execute
usage
run-kit code commands [--folder <path>] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--folder | string | Target host by workspace folder (default: git toplevel of the cwd) | |
--host | string | Target host by id (see rk code hosts) | |
--tabstring[=" | auto"] Target the host whose folder is the tab's @rk_win_code_root (bare --tab = the caller's own tab; pass @N for another) | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit code commands [--folder <path>] [flags]
Flags:
--folder string Target host by workspace folder (default: git toplevel of the cwd)
--host string Target host by id (see rk code hosts)
--tab string[=" auto"] Target the host whose folder is the tab's @rk_win_code_root (bare --tab = the caller's own tab; pass @N for another)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit code execExecute a VS Code command in a code-bridge host
usage
run-kit code exec <command> [json-arg…] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--all | Fan out to every live host | ||
--folder | string | Target host by workspace folder (default: git toplevel of the cwd) | |
--host | string | Target host by id (see rk code hosts) | |
--json | Print the raw response envelope instead of the result | ||
--tabstring[=" | auto"] Target the host whose folder is the tab's @rk_win_code_root (bare --tab = the caller's own tab; pass @N for another; --all ignores it) | ||
--timeout | duration | Timeout the extension enforces on the command (the Go deadline adds 2s) (default 30s) | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit code exec <command> [json-arg…] [flags]
Flags:
--all Fan out to every live host
--folder string Target host by workspace folder (default: git toplevel of the cwd)
--host string Target host by id (see rk code hosts)
--json Print the raw response envelope instead of the result
--tab string[=" auto"] Target the host whose folder is the tab's @rk_win_code_root (bare --tab = the caller's own tab; pass @N for another; --all ignores it)
--timeout duration Timeout the extension enforces on the command (the Go deadline adds 2s) (default 30s)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit code hostsList live code-bridge hosts
usage
run-kit code hosts [--json] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--json | Print the host records as a JSON array | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit code hosts [--json] [flags]
Flags:
--json Print the host records as a JSON array
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit code-serverManage the rk-owned code-server install (the /code lens editor)
usage
run-kit code-server [command]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit code-server [command]
Available Commands:
install Download the latest code-server release and activate it
start Start the daemon-managed code-server session now
update Update the managed code-server to the latest release
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
Use "run-kit code-server [command] --help" for more information about a command.
run-kit code-server installDownload the latest code-server release and activate it
usage
run-kit code-server install [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit code-server install [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit code-server startStart the daemon-managed code-server session now
usage
run-kit code-server start [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit code-server start [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit code-server updateUpdate the managed code-server to the latest release
usage
run-kit code-server update [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit code-server update [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit daemonManage the background run-kit daemon (tmux-managed run-kit serve)
usage
run-kit daemon [command]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit daemon [command]
Available Commands:
restart Restart the run-kit daemon
run Run a command in a managed job window on the daemon's tmux server
start Start the run-kit daemon
status Show run-kit daemon state and current port owner
stop Stop the run-kit daemon
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
Use "run-kit daemon [command] --help" for more information about a command.
run-kit daemon restartRestart the run-kit daemon
usage
run-kit daemon restart [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
-f, --force | SIGTERM a non-daemon port holder between stop and start | ||
--full | Kill the whole rk-daemon tmux server (sibling sessions included) for a fresh server, reconnecting previously-up remote tunnels | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit daemon restart [flags]
Flags:
-f, --force SIGTERM a non-daemon port holder between stop and start
--full Kill the whole rk-daemon tmux server (sibling sessions included) for a fresh server, reconnecting previously-up remote tunnels
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit daemon runRun a command in a managed job window on the daemon's tmux server
usage
run-kit daemon run --window <name> -- <cmd> [args...] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--window | stringrequired | job window name in the rk-jobs session (required) | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit daemon run --window <name> -- <cmd> [args...] [flags]
Flags:
--window string job window name in the rk-jobs session (required)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit daemon startStart the run-kit daemon
usage
run-kit daemon start [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
-f, --force | SIGTERM a non-daemon port owner before starting | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit daemon start [flags]
Flags:
-f, --force SIGTERM a non-daemon port owner before starting
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit daemon statusShow run-kit daemon state and current port owner
usage
run-kit daemon status [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--json | Emit a machine-readable JSON object | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit daemon status [flags]
Flags:
--json Emit a machine-readable JSON object
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit daemon stopStop the run-kit daemon
usage
run-kit daemon stop [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
-f, --force | SIGTERM any non-daemon port holder after stopping | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit daemon stop [flags]
Flags:
-f, --force SIGTERM any non-daemon port holder after stopping
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit desktopInstall and update the Run Kit desktop app (macOS)
usage
run-kit desktop [command]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit desktop [command]
Available Commands:
install Download and install the Run Kit desktop app (quarantine-free)
status Show installed vs latest Run Kit desktop app version (read-only)
update Update the Run Kit desktop app when a newer release exists
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
Use "run-kit desktop [command] --help" for more information about a command.
run-kit desktop installDownload and install the Run Kit desktop app (quarantine-free)
usage
run-kit desktop install [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--force | reinstall even when the requested version is already installed | ||
--path | string | install directory (default "/Applications") | |
--version | string | install a specific release tag instead of the latest (e.g. v3.13.0) | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit desktop install [flags]
Flags:
--force reinstall even when the requested version is already installed
--path string install directory (default "/Applications")
--version string install a specific release tag instead of the latest (e.g. v3.13.0)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit desktop statusShow installed vs latest Run Kit desktop app version (read-only)
usage
run-kit desktop status [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--path | string | install directory (default "/Applications") | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit desktop status [flags]
Flags:
--path string install directory (default "/Applications")
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit desktop updateUpdate the Run Kit desktop app when a newer release exists
usage
run-kit desktop update [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--force | reinstall even when already current | ||
--path | string | install directory (default "/Applications") | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit desktop update [flags]
Flags:
--force reinstall even when already current
--path string install directory (default "/Applications")
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit doctorCheck runtime dependencies
usage
run-kit doctor [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--json | Emit the dependency report as JSON to stdout | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit doctor [flags]
Flags:
--json Emit the dependency report as JSON to stdout
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit muxTmux substrate operations (server create, messaging, pane capture/kill/process, pane enumeration, janitor, recovery, config scaffold, tmux guard)
usage
run-kit mux [command]
flags
| flag | type | description | copy |
|---|---|---|---|
-L, --server | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit mux [command]
Available Commands:
adopt Adopt an external tmux server into run-kit management
await Block until an agent pane reaches a state (or a file appears)
capture Capture a pane's scrollback with substrate context
guard Front the real tmux binary, blocking bare kill-server
init-conf Scaffold the rk-managed tmux.conf and tmux.d/ overrides under ~/.config/run-kit/
kill Kill a pane, gated on its agent state and server protection
new Create a detached tmux server on socket <name>
panes Enumerate every pane on the server with substrate facts
process Show the process tree running in a pane
reap Reap leaked test tmux servers and stale sockets by prefix
send Deliver a message into an agent's pane, gated on its agent state
snapshot Inspect and restore tmux server layout snapshots
Flags:
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
Use "run-kit mux [command] --help" for more information about a command.
run-kit mux adoptAdopt an external tmux server into run-kit management
usage
run-kit mux adopt <server> [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
examples
rk mux adopt ext1
show raw -h output
Usage:
run-kit mux adopt <server> [flags]
Examples:
rk mux adopt ext1
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
run-kit mux awaitBlock until an agent pane reaches a state (or a file appears)
usage
run-kit mux await [--any] <target>... [--until <state>[,<state>]] [--file <path>] [--after-active] [--timeout <secs>] [--notify[=msg]] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--after-active | Require observing the active state before an --until state counts | ||
--any | Accept one-or-more targets and wake on the FIRST to fire (report appends the firing pane) | ||
--file | string | Also wake when this path appears (OR-composed with the state signal) | |
--notifystring[=" | auto"] Send a Web Push when the signal fires (optional message; default "agent <target> is <report>") | ||
--timeout | running | Seconds before reporting running (0 = wait indefinitely) (default 300) | |
--until | string | Comma-separated agent states to wake on (active|waiting|idle) (default "idle") | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
show raw -h output
Usage:
run-kit mux await [--any] <target>... [--until <state>[,<state>]] [--file <path>] [--after-active] [--timeout <secs>] [--notify[=msg]] [flags]
Flags:
--after-active Require observing the active state before an --until state counts
--any Accept one-or-more targets and wake on the FIRST to fire (report appends the firing pane)
--file string Also wake when this path appears (OR-composed with the state signal)
--notify string[=" auto"] Send a Web Push when the signal fires (optional message; default "agent <target> is <report>")
--timeout running Seconds before reporting running (0 = wait indefinitely) (default 300)
--until string Comma-separated agent states to wake on (active|waiting|idle) (default "idle")
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
run-kit mux captureCapture a pane's scrollback with substrate context
usage
run-kit mux capture <target> [-l <lines>] [--json | --raw] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--json | Output as JSON with metadata | ||
-l, --lines | int | Number of scrollback lines to capture (default 50) | |
--raw | Output the captured text only, byte-identical to tmux's output | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
examples
rk mux capture %5 rk mux capture @3 --lines 200 rk mux capture %5 --raw rk mux capture %5 --json
show raw -h output
Usage:
run-kit mux capture <target> [-l <lines>] [--json | --raw] [flags]
Examples:
rk mux capture %5
rk mux capture @3 --lines 200
rk mux capture %5 --raw
rk mux capture %5 --json
Flags:
--json Output as JSON with metadata
-l, --lines int Number of scrollback lines to capture (default 50)
--raw Output the captured text only, byte-identical to tmux's output
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
run-kit mux guardFront the real tmux binary, blocking bare kill-server
usage
run-kit mux guard [tmux args...] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
show raw -h output
Usage:
run-kit mux guard [tmux args...] [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
run-kit mux init-confScaffold the rk-managed tmux.conf and tmux.d/ overrides under ~/.config/run-kit/
usage
run-kit mux init-conf [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--force | Overwrite the rk-managed tmux.conf; overrides in tmux.d/ are untouched | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
show raw -h output
Usage:
run-kit mux init-conf [flags]
Flags:
--force Overwrite the rk-managed tmux.conf; overrides in tmux.d/ are untouched
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
run-kit mux killKill a pane, gated on its agent state and server protection
usage
run-kit mux kill <target> [--force] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--force | Skip the agent-state and protected-server gates (the target must still exist) | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
examples
rk mux kill %12 rk mux kill %12 --force rk mux kill @3
show raw -h output
Usage:
run-kit mux kill <target> [--force] [flags]
Examples:
rk mux kill %12
rk mux kill %12 --force
rk mux kill @3
Flags:
--force Skip the agent-state and protected-server gates (the target must still exist)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
run-kit mux newCreate a detached tmux server on socket <name>
usage
run-kit mux new <name> [--ephemeral] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--ephemeral | Mark the new server @rk_srv_ephemeral 1 (creator opt-out: reaped by rk mux reap --ephemeral, skipped by layout snapshots) | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
examples
rk mux new scratch1 rk mux new scratch2 --ephemeral
show raw -h output
Usage:
run-kit mux new <name> [--ephemeral] [flags]
Examples:
rk mux new scratch1
rk mux new scratch2 --ephemeral
Flags:
--ephemeral Mark the new server @rk_srv_ephemeral 1 (creator opt-out: reaped by rk mux reap --ephemeral, skipped by layout snapshots)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
run-kit mux panesEnumerate every pane on the server with substrate facts
usage
run-kit mux panes [--json] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--json | Output as JSON | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
examples
rk mux panes rk mux panes --json rk mux panes -L foo
show raw -h output
Usage:
run-kit mux panes [--json] [flags]
Examples:
rk mux panes
rk mux panes --json
rk mux panes -L foo
Flags:
--json Output as JSON
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
run-kit mux processShow the process tree running in a pane
usage
run-kit mux process <target> [--json] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--json | Output as JSON | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
examples
rk mux process %5 rk mux process %5 --json
show raw -h output
Usage:
run-kit mux process <target> [--json] [flags]
Examples:
rk mux process %5
rk mux process %5 --json
Flags:
--json Output as JSON
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
run-kit mux reapReap leaked test tmux servers and stale sockets by prefix
usage
run-kit mux reap [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--all | print the full list instead of the default 10-entry-per-list cap (display-only) | ||
--dry-run | explicit alias for the default preview-only behavior | ||
--ephemeral | also match live servers carrying the @rk_srv_ephemeral creator opt-out mark (union with the prefix match) | ||
--force | act, and bypass the dangerous-prefix guard (empty or ≤3-char prefix) | ||
--prefix | string | socket-name prefix to match (bare reap ≡ --prefix rk-test) (default "rk-test") | |
--yes | actually reap matched servers/sockets (default is dry-run preview) | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
show raw -h output
Usage:
run-kit mux reap [flags]
Flags:
--all print the full list instead of the default 10-entry-per-list cap (display-only)
--dry-run explicit alias for the default preview-only behavior
--ephemeral also match live servers carrying the @rk_srv_ephemeral creator opt-out mark (union with the prefix match)
--force act, and bypass the dangerous-prefix guard (empty or ≤3-char prefix)
--prefix string socket-name prefix to match (bare reap ≡ --prefix rk-test) (default "rk-test")
--yes actually reap matched servers/sockets (default is dry-run preview)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
run-kit mux sendDeliver a message into an agent's pane, gated on its agent state
usage
run-kit mux send <target> [<message> | -] [--key <key>]... [--answer | --force] [--no-enter] [--await[=<states>]] [--timeout <secs>] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--answer | This send answers the target's pending question (a waiting pane accepts it) | ||
--awaitstring[=" | auto"] After submitting, block until the peer reaches one of these states (optional set; default idle,waiting) | ||
--force | Skip the agent-state gate (the target must still exist) | ||
--key | stringArray | Send a tmux key name instead of text (repeatable; e.g. --key Enter, --key C-c) | |
--no-enter | Stage the text in the input box without submitting (no Enter) | ||
--timeout | running | Seconds the --await phase may run before reporting running (0 = indefinite) (default 300) | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
examples
rk mux send %5 "keep going" rk mux send @3 - < prompt.txt rk mux send =work:agent --key Enter
show raw -h output
Usage:
run-kit mux send <target> [<message> | -] [--key <key>]... [--answer | --force] [--no-enter] [--await[=<states>]] [--timeout <secs>] [flags]
Examples:
rk mux send %5 "keep going"
rk mux send @3 - < prompt.txt
rk mux send =work:agent --key Enter
Flags:
--answer This send answers the target's pending question (a waiting pane accepts it)
--await string[=" auto"] After submitting, block until the peer reaches one of these states (optional set; default idle,waiting)
--force Skip the agent-state gate (the target must still exist)
--key stringArray Send a tmux key name instead of text (repeatable; e.g. --key Enter, --key C-c)
--no-enter Stage the text in the input box without submitting (no Enter)
--timeout running Seconds the --await phase may run before reporting running (0 = indefinite) (default 300)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
run-kit mux snapshotInspect and restore tmux server layout snapshots
usage
run-kit mux snapshot [command]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
show raw -h output
Usage:
run-kit mux snapshot [command]
Available Commands:
list List available layout snapshots (live + died)
restore Recreate a dead server's layout from its snapshot
show Print a stored layout (sessions → windows → pane cwds) without acting
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
Use "run-kit mux snapshot [command] --help" for more information about a command.
run-kit mux snapshot listList available layout snapshots (live + died)
usage
run-kit mux snapshot list [<server>] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--all | print the full list instead of the default 10-row cap (display-only) | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
show raw -h output
Usage:
run-kit mux snapshot list [<server>] [flags]
Flags:
--all print the full list instead of the default 10-row cap (display-only)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
run-kit mux snapshot restoreRecreate a dead server's layout from its snapshot
usage
run-kit mux snapshot restore <server> [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--at | int | restore a history/tombstone entry by its unix timestamp (default: latest) | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
show raw -h output
Usage:
run-kit mux snapshot restore <server> [flags]
Flags:
--at int restore a history/tombstone entry by its unix timestamp (default: latest)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
run-kit mux snapshot showPrint a stored layout (sessions → windows → pane cwds) without acting
usage
run-kit mux snapshot show <server> [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--at | int | select a history/tombstone entry by its unix timestamp (default: latest) | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server) |
No flags match that filter.
show raw -h output
Usage:
run-kit mux snapshot show <server> [flags]
Flags:
--at int select a history/tombstone entry by its unix timestamp (default: latest)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (pane-scoped verbs: send/await/capture/kill/process, and the panes enumeration; default: the caller's own server from $TMUX, else the default server)
run-kit notifySend a Web Push notification to subscribed devices
usage
run-kit notify <message> [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--title | string | Optional notification title | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit notify <message> [flags]
Flags:
--title string Optional notification title
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit presentShow a file, directory, port, or URL to the user as a web tile
usage
run-kit present <target> [--window[=name]] [--notify[=msg]] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--notifystring[=" | auto"] Send a Web Push after attaching (optional message; defaults to "presenting <basename>") | ||
--windowstring[=" | auto"] Spawn a standalone iframe window instead of attaching to this window (optional name; defaults from the target) | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit present <target> [--window[=name]] [--notify[=msg]] [flags]
Flags:
--notify string[=" auto"] Send a Web Push after attaching (optional message; defaults to "presenting <basename>")
--window string[=" auto"] Spawn a standalone iframe window instead of attaching to this window (optional name; defaults from the target)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit remoteUse SSH-only machines as run-kit hosts (bootstrap, tunnel, connect)
usage
run-kit remote [command]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit remote [command]
Available Commands:
add Register a remote and assign its stable local port
connect Bootstrap if needed, start the remote daemon, open the tunnel
disconnect Close the tunnel window (the remote daemon keeps running)
list All remotes with derived tunnel + remote daemon state
remove Disconnect and drop the registration (remote install untouched)
status Single-remote detail, including version skew
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
Use "run-kit remote [command] --help" for more information about a command.
run-kit remote addRegister a remote and assign its stable local port
usage
run-kit remote add <target> [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--local-port | int | local tunnel port from the reserved 3100-3199 range (default: lowest free) | |
--name | string | remote name (default: derived from the target's host token) | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit remote add <target> [flags]
Flags:
--local-port int local tunnel port from the reserved 3100-3199 range (default: lowest free)
--name string remote name (default: derived from the target's host token)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit remote connectBootstrap if needed, start the remote daemon, open the tunnel
usage
run-kit remote connect <name|target> [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit remote connect <name|target> [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit remote disconnectClose the tunnel window (the remote daemon keeps running)
usage
run-kit remote disconnect <name> [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit remote disconnect <name> [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit remote listAll remotes with derived tunnel + remote daemon state
usage
run-kit remote list [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit remote list [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit remote removeDisconnect and drop the registration (remote install untouched)
usage
run-kit remote remove <name> [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit remote remove <name> [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit remote statusSingle-remote detail, including version skew
usage
run-kit remote status <name> [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit remote status <name> [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit riffCreate a worktree, tmux window, and Claude Code session
usage
run-kit riff [preset] [--skill <skill>...] [--cmd <cmd>...] [--layout <name>] [--count <N>] [--preset <name>] [--list-presets] [-- <wt-flags>...] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--cmdcmd[=__rk_riff_pane_bare__] | Shell command for a pane (repeatable; bare form drops into $SHELL) | ||
-N, --count | int | Spawn N worktree/window pairs in parallel (N >= 1) (default 1) | |
--layout | string | Pane layout (default "auto"). layout name (canonical + shortform): a, auto — pane-count-based: 1 pane = no layout 2 panes = even-horizontal 3+ panes = tiled t, tiled — grid ┌───┬───┐ │ 0 │ 1 │ ├───┼───┤ │ 2 │ 3 │ └───┴───┘ h, even-horizontal — side-by-side ┌───┬───┬───┐ │ 0 │ 1 │ 2 │ └───┴───┴───┘ v, even-vertical — stacked ┌───────────┐ │ 0 │ ├───────────┤ │ 1 │ ├───────────┤ │ 2 │ └───────────┘ deck-h, main-horizontal — main on top, deck below ┌───────────┐ │ 0 │ ├───┬───┬───┤ │ 1 │ 2 │ 3 │ └───┴───┴───┘ deck-v, main-vertical — main on left, deck right ┌───────┬───┐ │ │ 1 │ │ 0 ├───┤ │ │ 2 │ │ ├───┤ │ │ 3 │ └───────┴───┘ (default "auto") | |
--list-presets | List defined presets and exit | ||
--preset | string | Named preset from fab/project/config.yaml (riff.presets.<name>) | |
--skillskill[=__rk_riff_pane_bare__] | Claude Code skill/slash-command for a pane (repeatable; bare form launches a blank Claude session) | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit riff [preset] [--skill <skill>...] [--cmd <cmd>...] [--layout <name>] [--count <N>] [--preset <name>] [--list-presets] [-- <wt-flags>...] [flags]
Flags:
--cmd cmd[=__rk_riff_pane_bare__] Shell command for a pane (repeatable; bare form drops into $SHELL)
-N, --count int Spawn N worktree/window pairs in parallel (N >= 1) (default 1)
--layout string Pane layout (default "auto"). layout name (canonical + shortform):
a, auto — pane-count-based:
1 pane = no layout
2 panes = even-horizontal
3+ panes = tiled
t, tiled — grid
┌───┬───┐
│ 0 │ 1 │
├───┼───┤
│ 2 │ 3 │
└───┴───┘
h, even-horizontal — side-by-side
┌───┬───┬───┐
│ 0 │ 1 │ 2 │
└───┴───┴───┘
v, even-vertical — stacked
┌───────────┐
│ 0 │
├───────────┤
│ 1 │
├───────────┤
│ 2 │
└───────────┘
deck-h, main-horizontal — main on top, deck below
┌───────────┐
│ 0 │
├───┬───┬───┤
│ 1 │ 2 │ 3 │
└───┴───┴───┘
deck-v, main-vertical — main on left, deck right
┌───────┬───┐
│ │ 1 │
│ 0 ├───┤
│ │ 2 │
│ ├───┤
│ │ 3 │
└───────┴───┘
(default "auto")
--list-presets List defined presets and exit
--preset string Named preset from fab/project/config.yaml (riff.presets.<name>)
--skill skill[=__rk_riff_pane_bare__] Claude Code skill/slash-command for a pane (repeatable; bare form launches a blank Claude session)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit roleMark or unmark the current window as the server's operator
usage
run-kit role <operator|clear> [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit role <operator|clear> [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit serveStart the HTTP server (foreground)
usage
run-kit serve [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit serve [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit skillPrint run-kit's agent skill bundle (static usage briefing)
usage
run-kit skill [topic] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit skill [topic] [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit statusShow tmux session summary
usage
run-kit status [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--json | Emit the session summary as JSON to stdout | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit status [flags]
Flags:
--json Emit the session summary as JSON to stdout
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit tabDrive a tab's UI state — layout, web tabs, code root — from the shell
usage
run-kit tab [command]
flags
| flag | type | description | copy |
|---|---|---|---|
-L, --server | string | tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit tab [command]
Available Commands:
code Set the code surface's folder
layout Read or mutate a tab's surface layout
new Create a window, optionally born with a layout
show Dump every @rk_win_* option of a tab
web Add, remove, select, or list a tab's web tabs
Flags:
-L, --server string tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
Use "run-kit tab [command] --help" for more information about a command.
run-kit tab codeSet the code surface's folder
usage
run-kit tab code [command]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N |
No flags match that filter.
show raw -h output
Usage:
run-kit tab code [command]
Available Commands:
set Point the tab's code surface at a folder
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N
Use "run-kit tab code [command] --help" for more information about a command.
run-kit tab code setPoint the tab's code surface at a folder
usage
run-kit tab code set [@N] <folder> [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N |
No flags match that filter.
show raw -h output
Usage:
run-kit tab code set [@N] <folder> [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N
run-kit tab layoutRead or mutate a tab's surface layout
usage
run-kit tab layout [@N] [L | --add S | --rm S | --promote S | --cycle] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--add | string | Append a surface to the layout (grows the shape) | |
--cycle | Cycle to the next same-arity shape preset | ||
--promote | string | Move a surface to slot A | |
--rm | string | Remove a surface from the layout (collapses the shape) | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N |
No flags match that filter.
show raw -h output
Usage:
run-kit tab layout [@N] [L | --add S | --rm S | --promote S | --cycle] [flags]
Flags:
--add string Append a surface to the layout (grows the shape)
--cycle Cycle to the next same-arity shape preset
--promote string Move a surface to slot A
--rm string Remove a surface from the layout (collapses the shape)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N
run-kit tab newCreate a window, optionally born with a layout
usage
run-kit tab new [--session =S] [--cwd DIR] [--name N] [--layout L] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--cwd | string | Start directory for the window (default: the caller's cwd) | |
--layout | string | Layout the window is born with, e.g. split-h:tty,web (validated before creation) | |
--name | string | Window name (default: tmux's own) | |
--session | string | Session to create the window in, in the =S exact form (default: the caller's current session, else the server's current session) | |
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N |
No flags match that filter.
show raw -h output
Usage:
run-kit tab new [--session =S] [--cwd DIR] [--name N] [--layout L] [flags]
Flags:
--cwd string Start directory for the window (default: the caller's cwd)
--layout string Layout the window is born with, e.g. split-h:tty,web (validated before creation)
--name string Window name (default: tmux's own)
--session string Session to create the window in, in the =S exact form (default: the caller's current session, else the server's current session)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N
run-kit tab showDump every @rk_win_* option of a tab
usage
run-kit tab show [@N] [--json] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--json | Print the options as a flat JSON object | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N |
No flags match that filter.
show raw -h output
Usage:
run-kit tab show [@N] [--json] [flags]
Flags:
--json Print the options as a flat JSON object
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N
run-kit tab webAdd, remove, select, or list a tab's web tabs
usage
run-kit tab web [command]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N |
No flags match that filter.
show raw -h output
Usage:
run-kit tab web [command]
Available Commands:
add Attach a file, directory, port, or URL to a tab's web-tab strip
ls List a tab's web tabs
rm Remove a web tab from a tab's strip
select Select the active web tab of a tab's strip
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N
Use "run-kit tab web [command] --help" for more information about a command.
run-kit tab web addAttach a file, directory, port, or URL to a tab's web-tab strip
usage
run-kit tab web add [@N] <target> [--show] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--show | Ensure web is in the tab's layout after adding, then select the tab | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N |
No flags match that filter.
show raw -h output
Usage:
run-kit tab web add [@N] <target> [--show] [flags]
Flags:
--show Ensure web is in the tab's layout after adding, then select the tab
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N
run-kit tab web lsList a tab's web tabs
usage
run-kit tab web ls [@N] [--json] [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--json | Print the family as a JSON object | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N |
No flags match that filter.
show raw -h output
Usage:
run-kit tab web ls [@N] [--json] [flags]
Flags:
--json Print the family as a JSON object
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N
run-kit tab web rmRemove a web tab from a tab's strip
usage
run-kit tab web rm [@N/]web/<n> [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N |
No flags match that filter.
show raw -h output
Usage:
run-kit tab web rm [@N/]web/<n> [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N
run-kit tab web selectSelect the active web tab of a tab's strip
usage
run-kit tab web select [@N/]web/<n> [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) | ||
-L, --serverglobal | string | tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N |
No flags match that filter.
show raw -h output
Usage:
run-kit tab web select [@N/]web/<n> [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
-L, --server string tmux server name (default: the caller's own server from $TMUX, else the default server); requires an explicit @N
run-kit updateUpdate the run-kit CLI and desktop app to the latest version
usage
run-kit update [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--skip-brew-update | Skip the internal 'brew update' tap-metadata refresh (still runs brew info/upgrade and restarts the daemon) | ||
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit update [flags]
Aliases:
update, upgrade
Flags:
--skip-brew-update Skip the internal 'brew update' tap-metadata refresh (still runs brew info/upgrade and restarts the daemon)
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)
run-kit urlPrint the run-kit server URL (env → tmux option → default)
usage
run-kit url [flags]
flags
| flag | type | description | copy |
|---|---|---|---|
--quietglobal | Suppress progress/decoration/chatter (data and errors still print) |
No flags match that filter.
show raw -h output
Usage:
run-kit url [flags]
Global Flags:
--quiet Suppress progress/decoration/chatter (data and errors still print)