### Quick start: daemon, dashboard, and tutorial

Source: https://hexokit.com/docs/readme

Quick start commands from install to a guided tour. Starts the dashboard daemon on :6123, opens the dashboard (xdg-open on Linux), and runs a guided first-run tutorial.

```bash
rk daemon start                 # start the dashboard daemon on :6123
open http://localhost:6123      # 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
```

--------------------------------

### Set up dashboard and agent workspace

Source: https://hexokit.com/docs/install

Clean install to a working dashboard with one agent running. `shll setup agent` is optional once per machine and shows agent busy/waiting/idle in the dashboard. `rk daemon start` starts the dashboard daemon on :6123. `open http://localhost:6123` opens the dashboard in your browser. `rk riff` spawns an agent workspace (--skill /name picks the slash-command). The last step also needs `wt` and your agent CLI on PATH.

```bash
shll setup agent                # optional, once per machine: agent busy/waiting/idle in the dashboard
rk daemon start                 # start the dashboard daemon on :6123
open http://localhost:6123      # open the dashboard in your browser

# in a tmux session (tmux new -s work if you aren't in one):
rk riff                         # spawn an agent workspace (--skill /name picks the slash-command)
```

--------------------------------

### Tailscale Serve quickstart

Source: https://hexokit.com/docs/install

Starts Tailscale Serve in the background, making HexoKit available at `https://<machine>.<tailnet>.ts.net`.

```bash
tailscale serve --bg http://localhost:6123
```

--------------------------------

### Install and run an unknown window manager binary

Source: https://hexokit.com/docs/gui

To run a window manager not in the known list, install it yourself with `sudo apt install <pkg>`, then start it with `rk gui wm <starter> --restart`. Note that unlisted binaries run bare without the D-Bus session, so panels and trays may fail on the headless display.

```bash
sudo apt install <pkg>
```

```bash
rk gui wm <starter> --restart
```

--------------------------------

### Install HexoKit CLI and desktop app on Linux

Source: https://hexokit.com/docs/install

Recommended Linux path: first install the CLI via the toolkit installer, then run `rk desktop install` to install the app.

```bash
curl -fsSL https://hexokit.com/install | sh -s -- hexokit   # installs the CLI
rk desktop install                                          # installs the app
```

--------------------------------

### hexokit mux adopt example

Source: https://hexokit.com/docs/commands

Example of adopting an external tmux server named 'ext1'.

```text
rk mux adopt ext1
```

--------------------------------

### rk gui launch terminal and browser examples

Source: https://hexokit.com/docs/skill/gui

Shows launching the allowlisted terminal and browser roles. The terminal command prints the started process and display, while the browser with --cdp also prints the CDP endpoint.

```bash
rk gui launch terminal              # started x-terminal-emulator (pid 12345) on :10
rk gui launch browser --cdp         # + a second line: cdp http://127.0.0.1:9222
```

--------------------------------

### Development setup and run commands

Source: https://hexokit.com/docs/install

Run `just doctor` to check prerequisites, then use these commands to set up and run the development environment. `just setup` is a one-time setup, `just dev` runs in watch mode on a derived port, `just dev --port 4000` runs on an explicit port, and `just prod` runs from a built binary.

```bash
just setup             # one-time: frontend deps, Playwright browsers, .env.local, tmux.conf embed staging
just dev               # watch mode (Go backend + Vite dev server) on this worktree's derived port
just dev --port 4000   # same, on an explicit port (Vite on 4000, backend on 4001, code-server on 4002)
just prod              # run from built binary
```

--------------------------------

### hexokit desktop install --help output

Source: https://hexokit.com/docs/commands

Shows the raw help output for 'hexokit desktop install', including --force, --path, and --version flags.

```text
Usage:
  hexokit desktop install [flags]

Flags:
      --force            reinstall even when the requested version is already installed
      --path string      install directory (default: /Applications on macOS, ~/.local/state/hexokit/desktop on Linux)
      --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)

```

--------------------------------

### Manual iframe window setup for older rk versions

Source: https://hexokit.com/docs/skill/display

Manual recipe for older rk versions lacking the `present` command. Spawns an iframe window by hand, serving content yourself (e.g. `python3 -m http.server --bind 127.0.0.1 <port> -d <dir> &`). Change the page later by re-setting `@rk_win_web_1`. Every step SHALL fail silently if its prerequisite is unavailable (HexoKit missing, port in use, server fails to start) — skip the remaining steps without surfacing an error.

```shell
tmux new-window -n <name>
tmux set-option -w @rk_win_layout web
tmux set-option -w @rk_win_web_1 /proxy/<port>/<filename>
tmux set-option -w @rk_win_web_active 1
```

--------------------------------

### hexokit ports examples

Source: https://hexokit.com/docs/commands

Example invocations of the ports command, showing plain and JSON output.

```bash
rk ports
```

```bash
rk ports --json
```

--------------------------------

### hexokit agent setup -h output

Source: https://hexokit.com/docs/commands

Raw help output for the 'hexokit agent setup' command, showing usage and flags including --dry-run, --uninstall, and --yes.

```text
Usage:
  hexokit 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)

```

--------------------------------

### Quick start: rk riff examples

Source: https://hexokit.com/docs/workflows

Basic usage of `rk riff` with default skill, specific skill, and skill with command. Requires tmux session, git repo, `wt` on PATH, and launcher availability.

```bash
rk riff                                   # 1 pane, default skill (/fab-discuss)
rk riff --skill /review                   # 1 pane, specific slash-command
rk riff --skill /fab-fff --cmd "just dev" # 2 panes (agent + dev server)
```

--------------------------------

### hexokit code-server start help output

Source: https://hexokit.com/docs/commands

Shows the raw help output for the hexokit code-server start command, including the global --quiet flag.

```text
Usage:
  hexokit code-server start [flags]

Global Flags:
      --quiet   Suppress progress/decoration/chatter (data and errors still print)

```

--------------------------------

### hexokit code-server install help output

Source: https://hexokit.com/docs/commands

Shows the raw help output for the hexokit code-server install command, including the global --quiet flag.

```text
Usage:
  hexokit code-server install [flags]

Global Flags:
      --quiet   Suppress progress/decoration/chatter (data and errors still print)

```

--------------------------------

### rk gui clip and open usage examples

Source: https://hexokit.com/docs/skill/gui

Shows usage of rk gui clip set/get and rk gui open for URLs and files. clip set reads from stdin, clip get outputs the CLIPBOARD selection verbatim, and open uses xdg-open for URLs or absolute file paths.

```bash
rk gui clip set --stdin < paragraph.txt   # then: rk gui key ctrl+v
rk gui clip get                           # the CLIPBOARD selection, verbatim on stdout
rk gui open https://example.com           # xdg-open, detached: started <pid> on :N
rk gui open ./report.pdf
```

--------------------------------

### hexokit daemon start --help output

Source: https://hexokit.com/docs/commands

Shows the raw help output for 'hexokit daemon start', including the -f/--force flag and global --quiet flag.

```text
Usage:
  hexokit 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)

```

--------------------------------

### hexokit cron list examples

Source: https://hexokit.com/docs/commands

Example invocations of the list command, including a JSON output variant with a custom server.

```text
  rk cron list
  rk cron list -L work --json
```

--------------------------------

### Layout example: main-vertical

Source: https://hexokit.com/docs/workflows

Example of using `--layout main-vertical` to arrange panes with main on left and deck on right.

```bash
rk riff --skill /a --cmd x --cmd y --layout main-vertical
```

--------------------------------

### Present tutorial chapter 2

Source: https://hexokit.com/docs/skill/tutorial

Run this command to present the tutorial page for chapter 2. It teaches the phrase '...and present it to me' to get live pages.

```bash
rk present "$RK/tutorial/tutorial.html#ch2"
```

--------------------------------

### hexokit mux process examples

Source: https://hexokit.com/docs/commands

Examples of using the hexokit mux process command to show the process tree in a pane, with optional --json flag.

```bash
  rk mux process %5
  rk mux process %5 --json
```

--------------------------------

### hexokit mux panes examples

Source: https://hexokit.com/docs/commands

Examples of using the hexokit mux panes command to list panes, with optional --json and -L flags.

```bash
  rk mux panes
  rk mux panes --json
  rk mux panes -L foo
```

--------------------------------

### hexokit mux sessions examples

Source: https://hexokit.com/docs/commands

Example invocations of the hexokit mux sessions command, including listing all sessions and outputting JSON.

```text
rk mux sessions
```

```text
rk mux sessions --all
```

```text
rk mux sessions --json
```

```text
rk mux sessions -L foo --all --json
```

--------------------------------

### hexokit tutorial usage

Source: https://hexokit.com/docs/commands

Usage line for the 'hexokit tutorial' command, which opens a guided tour.

```text
hexokit tutorial [--tier <role>] [flags]
```

--------------------------------

### hexokit mux send examples

Source: https://hexokit.com/docs/commands

Example invocations of the hexokit mux send command, including sending text, reading from a file, and sending a key.

```text
rk mux send %5 "keep going"
```

```text
rk mux send @3 - < prompt.txt
```

```text
rk mux send =work:agent --key Enter
```

--------------------------------

### Install HexoKit via shll bootstrap

Source: https://hexokit.com/docs/install

Installs HexoKit (plus the shll meta-CLI) via Homebrew, handling tap trust automatically, and puts the `hexokit` binary on your PATH. The formula also installs `rk` as a fully interchangeable short alias. The legacy `sh -s -- run-kit` bootstrap argument still works.

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

--------------------------------

### Start operator agent

Source: https://hexokit.com/docs/skill/tutorial

Run this command to start the operator agent when no operator is present. It opens the pinned singleton and boots the operator agent.

```bash
rk operator
```

--------------------------------

### hexokit desktop --help output

Source: https://hexokit.com/docs/commands

Shows the raw help output for 'hexokit desktop', listing available subcommands: install, status, uninstall, update.

```text
Usage:
  hexokit desktop [command]

Available Commands:
  install     Download and install the HexoKit desktop app
  status      Show installed vs latest HexoKit desktop app version (read-only)
  uninstall   Remove the HexoKit desktop app and its desktop integration (Linux)
  update      Update the HexoKit desktop app when a newer release exists

Global Flags:
      --quiet   Suppress progress/decoration/chatter (data and errors still print)

Use "hexokit desktop [command] --help" for more information about a command.

```

--------------------------------

### Check for HexoKit's rk command and exit if missing

Source: https://hexokit.com/docs/skill/cron

Place this gate at the start of a script before using HexoKit. It exits silently if the 'rk' command is unavailable, allowing the rest of the script to run only when HexoKit is installed.

```shell
command -v rk >/dev/null 2>&1 || exit 0
```

--------------------------------

### rk mux new examples

Source: https://hexokit.com/docs/commands

Examples of the rk mux new command with and without the --ephemeral flag.

```shell
  rk mux new scratch1
  rk mux new scratch2 --ephemeral
```

--------------------------------

### Install, update, and check desktop app status with rk desktop CLI

Source: https://hexokit.com/docs/install

Primary CLI commands for the desktop app on macOS and Linux. `rk desktop install` fetches and installs the latest release, `rk desktop update` is a no-op when already current, and `rk desktop status` shows installed vs latest version (read-only).

```bash
rk desktop install    # fetch the latest release and install it
rk desktop update     # same, but a no-op when already current
rk desktop status     # installed vs latest version (read-only)
```

--------------------------------

### Enable agent state with shll setup agent

Source: https://hexokit.com/docs/readme

Run once per machine to enable agent state reporting. Installs the shll toolkit skill and HexoKit's dashboard hooks, delegating to `rk agent setup`, which shows a settings diff and asks before writing. Re-running is idempotent and never touches other hooks; until run (and agent sessions restarted), agent state shows `—`.

```shell
shll setup agent            # places the shll toolkit skill + installs HexoKit's dashboard hooks
```

--------------------------------

### hexokit cron mute examples

Source: https://hexokit.com/docs/commands

Example invocations of the mute command, including a lease-based mute and unmute.

```text
  rk cron mute a3f9
  rk cron mute a3f9 --for 30m
  rk cron mute a3f9 --off
```

--------------------------------

### Install HexoKit toolkit

Source: https://hexokit.com/docs/readme

Installs the entire HexoKit toolkit via Homebrew, handling tap trust automatically. Requires tmux ≥ 3.4, checked at runtime; `rk doctor` reports your version.

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

--------------------------------

### rk mux inventory, panes, and sessions command examples

Source: https://hexokit.com/docs/skill/mux

Shows the three enumeration commands with their common flags. inventory returns live servers with JSON output; panes lists every pane once; sessions lists sessions, with --all including labeled infrastructure.

```bash
rk mux inventory --json      # all live servers; -L scopes one, --agents-only filters, --limit caps returned panes
rk mux panes                 # one row per pane (aligned table; --json wraps the array: {"ok":true,"result":[…]})
rk mux sessions --all        # one row per session; default lists user-facing only, --all adds labeled infrastructure
```

--------------------------------

### rk mux kill examples

Source: https://hexokit.com/docs/commands

Examples of the rk mux kill command with different targets and the --force flag.

```shell
  rk mux kill %12
  rk mux kill %12 --force
  rk mux kill @3
```

--------------------------------

### hexokit mux adopt raw help output

Source: https://hexokit.com/docs/commands

Raw help output for the adopt command, showing usage, examples, and global flags.

```text
Usage:
  hexokit 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 panes/sessions/inventory; inventory defaults to all live servers, other queries default: the caller's own server from $TMUX, else the default server)
```

--------------------------------

### hexokit cron add examples

Source: https://hexokit.com/docs/commands

Examples of using hexokit cron add with various scheduling options, including fixed intervals, idle intervals, backoff, cron expressions, and targeting specific roles or sessions.

```bash
rk cron add "check PRs" --every 1h
rk cron add "wake up" --idle-every 3m
rk cron add "tick" --backoff --min 2m --max 30m
rk cron add "nightly" --cron "0 3 * * *" --role operator
rk cron add "morning digest" --cron "0 9 * * *" --deliver skip-if-busy
rk cron add "operator tick" --backoff --min 3m --max 24m --wake-on agent-state-change --deliver skip-if-busy --role operator --if-absent respawn --respawn rk --respawn operator --respawn -L --respawn '{server}' --pinned
rk cron add "follow up" --every 2h --session 4fe2abc-1c3b-4f7e-9a2d-8b5c4e1f0a37
```

--------------------------------

### Enable the GUI with `rk gui on`

Source: https://hexokit.com/docs/gui

Starts a VNC X server (Xvnc) on a private display, a window manager, and the `rk-gui` supervisor tmux session, and reveals the 4th tile button (⌘4) in the dashboard. Use `rk gui status` to check the one-line state and `rk gui off` to tear it down.

```bash
rk gui on
```

--------------------------------

### rk mux inventory examples

Source: https://hexokit.com/docs/commands

Examples of the rk mux inventory command with various flags: --json, --agents-only, and -L work --limit 100.

```shell
  rk mux inventory --json
  rk mux inventory --agents-only --json
  rk mux inventory -L work --limit 100 --json
```

--------------------------------

### rk mux await usage examples

Source: https://hexokit.com/docs/skill/mux

Shows common invocations of `rk mux await` with options for waiting on idle, until states, file appearance, readiness, timeout, and notifications.

```bash
rk mux await %5                          # block until the pane's agent is idle
rk mux await %5 --until idle,waiting     # wake on finish OR a question back
rk mux await %5 --file /tmp/result.json  # OR-compose a file-appearance signal
rk mux await %5 --ready                  # wait for BOOT: `ready %5 (state)`, `ready %5 (echo)`, `parked %5`, or `narrow %5 (54x14)`
rk mux await %5 --timeout 120            # give up waiting after 120s
rk mux await %5 --notify                 # Web Push yourself/the human on wake
```

--------------------------------

### rk mux capture examples

Source: https://hexokit.com/docs/commands

Example invocations of the capture command showing various flag combinations: default capture, specifying line count, raw output, JSON output, and combined flags with classify.

```shell
rk mux capture %5
rk mux capture @3 --lines 200
rk mux capture %5 --raw
rk mux capture %5 --json
rk mux capture %5 --lines 20 --classify --json
```

--------------------------------

### Create a new agent window

Source: https://hexokit.com/docs/skill/tutorial

Run this command to create a new agent window named 'tour-worker' when the operator is missing. Then start the same agent CLI to deliver the brief.

```bash
rk tab new --name tour-worker
```

--------------------------------

### hexokit agent subcommand help

Source: https://hexokit.com/docs/commands

Shows the usage and available subcommands for 'hexokit agent'. The agent command is for agent instrumentation, with subcommands 'hook' and 'setup'. The global flag --quiet is available.

```text
Usage:
  hexokit 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 "hexokit agent [command] --help" for more information about a command.
```

--------------------------------

### rk operator request examples

Source: https://hexokit.com/docs/skill/messaging

Shows the rk operator request command with the --list flag to list the registry, and examples of server-scoped and window-scoped requests. Window-scoped templates require --window @N; --text is accepted only by spawn-task, find-discussion, and user-message; --session only by update-annotations. A busy operator queues the request and reports queued <template> with exit 0.

```bash
rk operator request --list                       # the registry: ids, scope, declared flags
rk operator request brief-me                     # server-scoped: a standup digest of every tab
rk operator request fix-tab-name --window @7     # window-scoped: work about a subject tab
rk operator request spawn-task --text "add retry to the flaky poll"
```

--------------------------------

### Check GUI status and gate

Source: https://hexokit.com/docs/skill/gui

Gate first: verify HexoKit is installed and check GUI status. If status is 'gui: off', stop and tell the user to run 'rk gui on' themselves. If 'gui: on — not running', suggest 'rk gui restart'. If 'gui: on (<backend>, :N, …)', the display is live.

```bash
command -v rk >/dev/null 2>&1 || exit 0
rk gui status    # "gui: off" / "gui: on (…)" / "gui: on — not running (…)"
```

--------------------------------

### hexokit cron rm raw help output

Source: https://hexokit.com/docs/commands

Raw -h output for hexokit cron rm, showing usage, example, and flags.

```text
Usage:
  hexokit cron rm <id> [flags]

Examples:
  rk cron rm a3f9

Flags:
      --json   Emit the machine-readable envelope (exactly one JSON document on stdout)

Global Flags:
      --quiet           Suppress progress/decoration/chatter (data and errors still print)
  -L, --server string   tmux server name (entry-file-scoped verbs: add/edit/list/rm/mute/pin; default: the caller's own server from $TMUX, else the default server)

```

--------------------------------

### Present tutorial chapter 1

Source: https://hexokit.com/docs/skill/tutorial

Run this command to present the tutorial page for chapter 1. The user should then ask a question to see the agent's state change.

```bash
rk present "$RK/tutorial/tutorial.html#ch1"
```

--------------------------------

### hexokit cron list -h output

Source: https://hexokit.com/docs/commands

Raw help output for the list command showing usage, examples, and flags.

```text
Usage:
  hexokit cron list [--json] [flags]

Examples:
  rk cron list
  rk cron list -L work --json

Flags:
      --json   Output as JSON

Global Flags:
      --quiet           Suppress progress/decoration/chatter (data and errors still print)
  -L, --server string   tmux server name (entry-file-scoped verbs: add/edit/list/rm/mute/pin; default: the caller's own server from $TMUX, else the default server)

```

--------------------------------

### hexokit mux panes -h output

Source: https://hexokit.com/docs/commands

Raw help output for the hexokit mux panes command, showing usage, examples, and flags.

```text
Usage:
  hexokit 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 panes/sessions/inventory; inventory defaults to all live servers, other queries default: the caller's own server from $TMUX, else the default server)
```

--------------------------------

### hexokit remote connect usage

Source: https://hexokit.com/docs/commands

Usage syntax for the 'hexokit remote connect' command, which bootstraps if needed, starts the remote daemon, and opens the tunnel.

```text
hexokit remote connect <name|target> [flags]
```

--------------------------------

### Set DISPLAY and run commands on the display

Source: https://hexokit.com/docs/skill/gui

Use 'rk gui env' to export DISPLAY and RK_GUI_SOCKET into your shell. Use 'rk gui exec' to run commands on the display: foreground replaces the process, --detach starts a new session, and -- ends flag parsing. Existing DISPLAY is overridden.

```bash
eval "$(rk gui env)"    # exports DISPLAY=:N and RK_GUI_SOCKET=<path>
rk gui exec xterm                                  # foreground: rk is replaced by the app
rk gui exec --detach chromium https://example.com  # launch and return
rk gui exec -- xdotool key --clearmodifiers minus  # `--` ends flag parsing
```

--------------------------------

### hexokit cron edit examples

Source: https://hexokit.com/docs/commands

Example invocations of `rk cron edit` (alias for hexokit cron edit) demonstrating schedule replacement, delivery policy, backoff ladder, wake-on configuration, and renaming.

```bash
rk cron edit a3f9 --idle-every 3m
rk cron edit a3f9 --deliver skip-if-busy
rk cron edit a3f9 --backoff --min 2m --max 10m
rk cron edit a3f9 --wake-on agent-state-change --wake-debounce 2m
rk cron edit a3f9 --wake-on none
rk cron edit a3f9 --name "morning digest"
```

--------------------------------

### hexokit mux process -h output

Source: https://hexokit.com/docs/commands

Raw help output for the hexokit mux process command, showing usage, examples, and flags.

```text
Usage:
  hexokit 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 panes/sessions/inventory; inventory defaults to all live servers, other queries default: the caller's own server from $TMUX, else the default server)
```

--------------------------------

### hexokit mux new -h output

Source: https://hexokit.com/docs/commands

Raw help output for hexokit mux new, showing usage, examples, flags, and global flags.

```text
Usage:
  hexokit 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)
      --json        Emit the machine-readable envelope (exactly one JSON document on stdout)

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 panes/sessions/inventory; inventory defaults to all live servers, other queries default: the caller's own server from $TMUX, else the default server)
```

--------------------------------

### hexokit cron pin raw help output

Source: https://hexokit.com/docs/commands

Raw -h output for hexokit cron pin, showing usage, examples, and flags.

```text
Usage:
  hexokit cron pin <id> [--off] [flags]

Examples:
  rk cron pin a3f9
  rk cron pin a3f9 --off

Flags:
      --off   Unpin instead of pin

Global Flags:
      --quiet           Suppress progress/decoration/chatter (data and errors still print)
  -L, --server string   tmux server name (entry-file-scoped verbs: add/edit/list/rm/mute/pin; default: the caller's own server from $TMUX, else the default server)

```

--------------------------------

### rk present --window examples

Source: https://hexokit.com/docs/skill/display

Use --window to attach a web tile to a new tmux window instead of the current one. The first form derives the tile name from the host; the second sets an explicit name. This is for external URLs with no owning pane or content that needs its own board-pinnable identity.

```bash
rk present --window https://staging.example.com   # name from the host
rk present --window=report ./dist/                # explicit name
```

--------------------------------

### Present tutorial chapter 3

Source: https://hexokit.com/docs/skill/tutorial

Run this command to present the tutorial page for chapter 3. It covers hiring a second agent and using the operator console.

```bash
rk present "$RK/tutorial/tutorial.html#ch3"
```

--------------------------------

### rk riff usage examples: two panes and parallel presets

Source: https://hexokit.com/docs/readme

Two example invocations of the `rk riff` workspace launcher. The first creates two panes (an agent plus a dev server) using the repeatable --skill and --cmd flags; the second spawns three parallel workspaces from the built-in 'discuss' preset with -N 3. Requires being inside a tmux session and a git repository (or passing --repo <path>).

```bash
rk riff --skill /fab-fff --cmd "just dev"       # 2 panes (agent + dev server)
rk riff discuss -N 3                            # 3 parallel 'discuss' preset workspaces
```

--------------------------------

### hexokit mux kill -h output

Source: https://hexokit.com/docs/commands

Raw help output for hexokit mux kill, showing usage, examples, flags, and global flags.

```text
Usage:
  hexokit 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)
      --json    Emit the machine-readable envelope (exactly one JSON document on stdout)

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 panes/sessions/inventory; inventory defaults to all live servers, other queries default: the caller's own server from $TMUX, else the default server)
```

--------------------------------

### hexokit mux inventory -h output

Source: https://hexokit.com/docs/commands

Raw help output for hexokit mux inventory, showing usage, examples, flags, and global flags.

```text
Usage:
  hexokit mux inventory [--agents-only] [--limit N] [--json] [flags]

Examples:
  rk mux inventory --json
  rk mux inventory --agents-only --json
  rk mux inventory -L work --limit 100 --json

Flags:
      --agents-only   Only return panes with agent evidence
      --json          Output as JSON
      --limit int     Maximum returned panes per server after filtering (1-5000) (default 500)

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 panes/sessions/inventory; inventory defaults to all live servers, other queries default: the caller's own server from $TMUX, else the default server)
```

--------------------------------

### Capture initial state and detect operator

Source: https://hexokit.com/docs/skill/tutorial

Preflight commands to create a working directory, capture the current tab state and web tabs, get the rk URL, and list tmux windows with operator role. Used to detect the operator and save state for cleanup.

```bash
mkdir -p /tmp/rk-tutorial
rk tab show --json > /tmp/rk-tutorial/original-state.json   # envelope — the tab data sits under .result
rk tab web ls --json > /tmp/rk-tutorial/original-webtabs.json 2>/dev/null || true
RK="$(rk url)"
tmux list-windows -a -f '#{||:#{==:#{@rk_win_role},operator},#{==:#{window_name},operator}}' -F '#{window_id} #{window_name}' || true
```

--------------------------------

### hexokit cron rm example

Source: https://hexokit.com/docs/commands

Example invocation of hexokit cron rm to remove entry a3f9.

```shell
rk cron rm a3f9
```

--------------------------------

### Enable HTTPS over Tailscale with tailscale serve

Source: https://hexokit.com/docs/readme

Run these commands to enable HTTPS for HexoKit on your tailnet. First, enable HTTPS certificates in the Tailscale admin console. Then run the one-time setup command to allow tailscale serve without sudo, and finally serve the local HexoKit instance on port 6123.

```shell
sudo tailscale set --operator=$USER
```

```shell
tailscale serve --bg http://localhost:6123
```

--------------------------------

### hexokit gui launch -h output

Source: https://hexokit.com/docs/commands

Raw help output for 'hexokit gui launch' showing usage and flags, including --cdp and --port.

```text
Usage:
  hexokit gui launch <terminal|browser> [flags]

Flags:
      --cdp        Browser only: open a CDP endpoint (Chromium-family) and print its URL
      --port int   CDP port for --cdp (default 9222)

Global Flags:
      --quiet   Suppress progress/decoration/chatter (data and errors still print)

```

--------------------------------

### rk cron add: schedule a prompt (--every, --backoff, --cron, --wake-on)

Source: https://hexokit.com/docs/skill/cron

Creates a cron entry from a single prompt. Each add requires exactly one schedule flag; the example shows fixed-interval, idle, backoff, cron, and combined with wake-on. On success it prints `<id> <name> [<schedule> -> <target>]`, or with `--json` a receipt object with the same four fields.

```bash
rk cron add "check PRs" --every 1h
rk cron add "wake up" --idle-every 3m
rk cron add "tick" --backoff --min 2m --max 30m
rk cron add "standup" --cron "0 9 * * *" --catch-up once
rk cron add "operator tick" --backoff --min 3m --max 24m --wake-on agent-state-change --deliver skip-if-busy --role operator --if-absent respawn --respawn rk --respawn operator --respawn -L --respawn '{server}' --pinned
```

--------------------------------

### rk mux send usage examples

Source: https://hexokit.com/docs/skill/mux

Shows various invocations of `rk mux send` with different targets, payloads, and options. Targets include pane `%N`, window `@N`, exact `=session:window`, and `-L <server>` for another tmux server. The `--answer` flag answers a waiting agent, and `--key` sends raw tmux key names.

```bash
rk mux send %5 "summarize the diff and report back"   # pane target, literal message
rk mux send %5 - < prompt.md                          # multi-line payload via stdin
rk mux send @3 "hi"                                   # window target → its agent pane
rk mux send =work:editor "hi"                         # exact session:window
rk mux send %5 "yes, go ahead" --answer               # answer a WAITING agent's question
rk mux send %5 --key Enter                            # raw tmux key names (no paste/probe)
```

--------------------------------

### hexokit cron pin examples

Source: https://hexokit.com/docs/commands

Example invocations of hexokit cron pin: pin entry a3f9 and unpin it with --off.

```shell
rk cron pin a3f9
rk cron pin a3f9 --off
```

--------------------------------

### Present Chapter 5

Source: https://hexokit.com/docs/skill/tutorial

Presents the tutorial chapter 5 to the worker using the rk present command.

```bash
rk present "$RK/tutorial/tutorial.html#ch5"
```

--------------------------------

### Present Chapter 4

Source: https://hexokit.com/docs/skill/tutorial

Presents the tutorial chapter 4 to the worker using the rk present command.

```bash
rk present "$RK/tutorial/tutorial.html#ch4"
```

--------------------------------

### rk cron add and manage scheduled commands

Source: https://hexokit.com/docs/skill/cron

Example commands for adding cron jobs in Hexokit's rk CLI, showing --every, --idle-every with --session, --cron with --catch-up and --role, and the --for mute flag. Note that a --cron entry without --catch-up waits for the next occurrence and unparsable schedules fail at add time.

```bash
rk cron add "check on PR #123 with gh and tell me if CI fails" --every 30m
```

```bash
rk cron add "post a status line on where you are" --idle-every 5m --session 4fe2abc-1c3b-4f7e-9a2d-8b5c4e1f0a37
```

```bash
rk cron add "morning standup soon — summarize what I have open" --cron "0 9 * * *" --catch-up once --role operator
```

```bash
rk cron mute "$(rk cron list --json | jq -r '.result[] | select(.name == "operator tick") | .id')" --for 2h
```

```bash
rk cron edit a3f9 --every 2h
```

--------------------------------

### hexokit tutorial -h output

Source: https://hexokit.com/docs/commands

Raw help output for the hexokit tutorial command, showing usage and flags including --tier and global --quiet.

```text
Usage:
  hexokit tutorial [--tier <role>] [flags]

Flags:
      --tier string   fab role tier the tour agent's launcher resolves from (default "fast")

Global Flags:
      --quiet   Suppress progress/decoration/chatter (data and errors still print)

```

--------------------------------

### Offer Phone Notification

Source: https://hexokit.com/docs/skill/tutorial

Sends a notification to the user's phone to open the tutorial on any device. Fails silently if the user is unsubscribed.

```bash
rk notify "open me on your phone" --title HexoKit
```

--------------------------------

### hexokit daemon run --help output

Source: https://hexokit.com/docs/commands

Shows the raw help output for 'hexokit daemon run', including the required --window flag and global --quiet flag.

```text
Usage:
  hexokit 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)

```

--------------------------------

### rk mux readiness and wall handling commands

Source: https://hexokit.com/docs/skill/messaging

Commands to check readiness, capture the screen, and interact with a parked wall (e.g., accept a trust prompt or move a picker selection). The await --ready command reports parked with the screen snippet on stderr.

```bash
rk mux await --ready %5            # → parked %5 (snippet on stderr)
rk mux capture %5                  # look closer if the snippet isn't enough
rk mux send %5 --key Enter         # accept a trust prompt
rk mux send %5 --key Down          # move a picker selection
```

--------------------------------

### hexokit mux init-conf -h output

Source: https://hexokit.com/docs/commands

Raw help output for the init-conf command, showing usage, the --force flag, and global flags.

```text
Usage:
  hexokit 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 panes/sessions/inventory; inventory defaults to all live servers, other queries default: the caller's own server from $TMUX, else the default server)
```

--------------------------------

### hexokit gui move -h output

Source: https://hexokit.com/docs/commands

Raw help output for 'hexokit gui move' showing usage and flags, including --force.

```text
Usage:
  hexokit gui move <x> <y> [flags]

Flags:
      --force   Act even when a human drove the display seconds ago

Global Flags:
      --quiet   Suppress progress/decoration/chatter (data and errors still print)

```

--------------------------------

### hexokit gui restart -h output

Source: https://hexokit.com/docs/commands

Raw help output for 'hexokit gui restart' showing usage and global flags.

```text
Usage:
  hexokit gui restart [flags]

Global Flags:
      --quiet   Suppress progress/decoration/chatter (data and errors still print)

```

--------------------------------

### rk gui clip get

Source: https://hexokit.com/docs/skill/gui

Retrieves the current clipboard selection and prints it verbatim to stdout.

```APIDOC
## rk gui clip get

### Description
Retrieves the current clipboard selection and prints it verbatim to stdout.

### Method
CLI

### Endpoint
rk gui clip get

### Parameters
None.

### Request Example
```
rk gui clip get
```

### Response
#### Success Response
- **stdout** (text) - The clipboard content.

#### Error Handling
- If neither xclip nor xsel is installed: `no clipboard tool found (tried xclip, xsel) — sudo apt install xclip`
```

--------------------------------

### hexokit ports raw -h output

Source: https://hexokit.com/docs/commands

Raw help output for the ports command, including usage, examples, and flags.

```bash
Usage:
  hexokit ports [flags]

Examples:
  rk ports
  rk ports --json

Flags:
      --json   Emit the policy as a {"ok","result"} envelope (stable shape for scripts)

Global Flags:
      --quiet   Suppress progress/decoration/chatter (data and errors still print)
```

--------------------------------

### hexokit gui open -h output

Source: https://hexokit.com/docs/commands

Raw help output for 'hexokit gui open' showing usage and global flags.

```text
Usage:
  hexokit gui open <url|file> [flags]

Global Flags:
      --quiet   Suppress progress/decoration/chatter (data and errors still print)

```

--------------------------------

### hexokit cron mute -h output

Source: https://hexokit.com/docs/commands

Raw help output for the mute command showing usage, examples, and flags.

```text
Usage:
  hexokit cron mute <id> [--for <dur>] [--off] [flags]

Examples:
  rk cron mute a3f9
  rk cron mute a3f9 --for 30m
  rk cron mute a3f9 --off

Flags:
      --for duration   Mute until now+<dur> (a self-expiring lease; positive Go duration; mutually exclusive with --off)
      --json           Emit the machine-readable envelope (exactly one JSON document on stdout)
      --off            Unmute instead of mute

Global Flags:
      --quiet           Suppress progress/decoration/chatter (data and errors still print)
  -L, --server string   tmux server name (entry-file-scoped verbs: add/edit/list/rm/mute/pin; default: the caller's own server from $TMUX, else the default server)

```

--------------------------------

### hexokit cron add raw -h output

Source: https://hexokit.com/docs/commands

The raw help output for hexokit cron add, showing usage and examples.

```bash
Usage:
  hexokit cron add <prompt> --every <dur> | --idle-every <dur> | --backoff | --cron "<expr>" [flags]

Examples:
  rk cron add "check PRs" --every 1h
  rk cron add "wake up" --idle-every 3m
  rk cron add "tick" --backoff --min 2m --max 30m
  rk cron add "nightly" --cron "0 3 * * *" --role operator
  rk cron add "morning digest" --cron "0 9 * * *" --deliver skip-if-busy
  rk cron add "operator tick" --backoff --min 3m --max 24m --wake-on agent-state-change --deliver skip-if-busy --role operator --if-absent respawn --respawn rk --respawn operator --respawn -L --respawn '{server}' --pinned
  rk cron add "follow up" --every 2h --session 4fe2abc-1c3b-4f7e-9a2d-8b5c4e1f0a37
```

--------------------------------

### hexokit gui resize -h output

Source: https://hexokit.com/docs/commands

Raw help output for 'hexokit gui resize' showing usage and global flags.

```text
Usage:
  hexokit gui resize <WxH|auto> [flags]

Global Flags:
      --quiet   Suppress progress/decoration/chatter (data and errors still print)

```

--------------------------------

### hexokit mux capture -h output

Source: https://hexokit.com/docs/commands

Raw help output for the capture command, showing usage, examples, flags, and global flags.

```text
Usage:
  hexokit mux capture <target> [-l <lines>] [--json | --raw] [--classify] [flags]

Examples:
  rk mux capture %5
  rk mux capture @3 --lines 200
  rk mux capture %5 --raw
  rk mux capture %5 --json
  rk mux capture %5 --lines 20 --classify --json

Flags:
      --classify    Classify the captured text for a pending prompt
      --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 panes/sessions/inventory; inventory defaults to all live servers, other queries default: the caller's own server from $TMUX, else the default server)
```