Skip to content

Chat and CLI commands

Command What it does
/help Show the command list.
/status Model, provider, credentials source, thread id with this conversation's turns and tokens, marimo state, kernel runtime and its log, web allowlist.
/new Start a new conversation thread (context files are re-read).
/model <name> or /model <provider>:<name> Switch model (and provider); starts a new thread.
/notebook, /notebook list, /notebook new <name> [--empty], /notebook open <name>, /notebook close [name] Show or switch the active notebook (see Working with several notebooks).
/exec <code> Run Python in the active notebook's kernel and print its output, result and errors. Nothing is sent to the model. The notebook must be open in the browser; a pasted block keeps its lines and is dedented.
/context List loaded context files, skills, prompts and the web allowlist.
/data, /data add <name> <folder>, /data remove <name> List the data folders, or add or remove one in .hailer/local.toml; the kernel gets the change at the next start.
/skill <name> [message] Run a turn with a project skill attached.
/prompt <name> [args] Send a saved prompt from the prompts folder (.config/hailer/prompts, or .hailer/prompts inside a project).
/reload Re-read the context, skills and prompts; applies from your next message.
/clear Clear the screen.
/exit, /quit Exit Hailer (Ctrl+C at the prompt, Ctrl+D on an empty line, or Ctrl+Z then Enter, also exit).

Interactive chat keeps a framed input box below the conversation. Your submitted messages, Hailer's replies and command results appear above it. While Hailer works, a live line above the box shows the step in progress (or what startup or a notebook switch waits for) with a timer. The footer below the box shows the active notebook (● open in the browser, ○ not open), the kernel (docker · isolated, or a yellow ▲ unsafe-local · not isolated), the model, and this conversation's turns and tokens (working 3.1s during a turn); it follows a notebook switch as soon as the tool that made it returns. When you leave, the last lines count this session only: Session ended · 4m 12s · this session: 2 turns, 1.1k tokens. Turns and tokens count finished turns: a cancelled or failed turn adds neither (the endpoint may still bill what it used).

Enter sends; Alt+Enter (or Ctrl+J) inserts a newline. Pasting several lines keeps them in one editable message. You can draft your next message while Hailer works; Enter preserves that draft until the current operation finishes or is cancelled. Requests are not queued.

Command menu. Typing / at the start of a message opens a menu of the commands under the input box, each with a short description. Keep typing to narrow it; Up and Down (or Tab and Shift+Tab) choose. Enter on a command you chose this way runs it at once when it takes no arguments (/help, /status, /new, /context, /reload, /clear, /exit, /notebook list); a command that takes arguments is completed with a space and the menu then offers them: the /notebook subcommands, notebook names after /notebook open or /notebook close, skill names after /skill, saved prompts after /prompt, and after /model the current model and each provider as <provider>: (suggestions only: a model name you type is sent as typed). If you have not chosen anything, Enter sends a command you typed in full (with a whole argument, if it has one) as typed, and otherwise only completes it to the first entry without running it: /n then Enter gives /new, and a second Enter starts the new conversation. Esc closes the menu (while a turn runs, the first Esc closes the menu and the next one cancels the turn). The menu only completes at the end of what you typed; Tab also opens it for the word being typed.

History. Up and Down move through multiline input and recall earlier messages at its boundaries, including messages from earlier sessions in this workspace. As you type, the rest of the latest earlier message that starts the same way appears in grey; → (Right) accepts it. History is kept in .hailer/input_history (.hailer/state/input_history in the project layout): the last 1,000 messages and commands. Two kinds stay in memory for the current session only and are never written there: a message over 64 KB (a large paste), and one that contains something that looks like a credential: a bearer token or Authorization: value, an sk- key, a URL with a password in it (user:password@), a GitHub token (ghp_, gho_, ghs_, ghu_, ghr_, github_pat_), an AWS access key ID (AKIA...), or the value of an environment variable ending in _KEY, _TOKEN, _SECRET or _PASSWORD. Other secrets, such as a password typed on its own or a private key, are not recognised. To keep history for the current session only, set input_history = false under [hailer] in hailer.toml.

The interface uses normal terminal scrollback and text selection. It does not capture the mouse or switch to an alternate screen. Use uvx hailer --plain or uvx hailer notebook --plain for the line-oriented You > interface. Pipes and terminals reporting TERM=dumb or TERM=unknown use plain input automatically.

Esc or Ctrl+C during a turn cancels the model request and keeps the composer open (when the command menu is open, Esc first closes it; the next Esc cancels). A notebook command already performing a blocking operation finishes its cleanup before another command can start. Cancellation does not undo tool actions that have already happened. Ctrl+C while idle exits; Ctrl+D on empty input or Ctrl+Z then Enter also exits. The conversation is stored in .hailer/threads.sqlite, which is how uvx hailer resumes it after a restart; /new (or uvx hailer --new) discards it and starts another. Completed replies are displayed once, with Markdown formatting; live activity does not print interim model commentary. /clear clears the display without resetting the conversation.

Other subcommands:

Command What it does
uvx hailer Start this session's own notebook server, open the notebook and chat in the terminal; the server stops when the chat ends.
uvx hailer notebook [--port N] [--no-browser] [--foreground] [--new] [--plain] [--kernel RUNTIME] The same session with extra startup options; marimo runs on the notebooks folder. RUNTIME is docker or unsafe-local (notebook code runs as you).
uvx hailer status Configuration, credentials and this workspace's running Docker kernels (whenever Docker is installed).
uvx hailer doctor The startup checks with fixes: configuration, credentials, Docker, the kernel image and folders. It starts no kernel.
uvx hailer login <provider>, uvx hailer logout <provider> Store or remove a provider's API key.
uvx hailer init [--force] [--kernel RUNTIME] [--layout standalone\|project] Set up a workspace (see Quick start). hailer.toml gets [kernel] runtime = "docker", or the --kernel runtime. In a folder with pyproject.toml or .git everything goes into .hailer/ (see Inside another project).
uvx hailer data [list], uvx hailer data add <name> <folder> [--description TEXT], uvx hailer data remove <name> The data folders notebooks see as DATA_FOLDERS["<name>"], read-only in the kernel; add and remove edit this machine's .hailer/local.toml.
uvx hailer kernel pull Download the kernel image for this Hailer (or [kernel].image).
uvx hailer kernel build [--tag <name>] Build the kernel image, discovering host pip/uv mirror settings. --pip-config FILE overrides discovery; --no-host-config disables it. See corporate mirrors.
uvx hailer kernel stop Remove every Docker container and network of this workspace, whichever session started it, and say what was removed.

Global options go before the subcommand: --verbose, --config <path>, --workspace <path>, --new, --plain, --version (for example uvx hailer --workspace C:\projects\sales kernel stop).

Environment variables

Everything else comes from hailer.toml and this machine's .hailer/local.toml (which wins over it); a variable wins over the files, and a command-line option over all of them.

Variable Overrides
HAILER_CONFIG The config file (--config)
HAILER_WORKSPACE The workspace folder (--workspace)
HAILER_MODEL, HAILER_MODEL_PROVIDER [model].name, [model].provider
HAILER_KERNEL [kernel].runtime (--kernel wins over it)
HAILER_KERNEL_IMAGE [kernel].image
HAILER_LOG_LEVEL [hailer].log_level
HAILER_TRACING Nothing in the file: set it to let LangSmith tracing variables apply (see Security)

The notebook and the notebooks and data folders are set only in hailer.toml ([hailer].notebook, notebooks_dir, data_dir).