CLI reference

Starting Harnez

harnez

Starts the server if one isn't already running and opens the TUI against it. The TUI and server are separate, so during development you can run them independently:

bun run server   # HARNEZ_PORT, default 7432
bun run tui      # HARNEZ_URL, default http://localhost:7432

Slash commands

Typed directly into the TUI composer.

CommandDescription
/login [provider]Open the provider-authentication wizard. Omit the provider to pick from a list.
/model [provider]Open the model picker for a provider, or the current one if omitted.
/model <provider> <model> [base-url]Set the active provider, model, and optional custom endpoint directly, without the wizard.
/<skill-name>Invoke a skill loaded from .harnez/skills or .agents/skills. Available skills appear in autocomplete with their own description.

Keyboard shortcuts

ShortcutEffect
EnterSubmit. This steers the active task if one is running.
Option/Alt + EnterSubmit as a queued follow-up, run after the active task finishes.
EscAbort the current step: generation, running tools, and anything pending in it.
Ctrl+TToggle visibility of the model's thinking blocks.
Cmd+CCopy the current terminal selection.
Ctrl+CQuit.
/ / TabNavigate and accept command or skill autocomplete suggestions.

Steering vs. aborting

These map directly onto the three ways to interrupt the agent loop: steer, queue a follow-up, or abort.