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).