The hob command
Every flag and subcommand of the hob command.
hob [OPTIONS] [PROMPT]
hob <COMMAND>Without a command, hob starts the TUI in the current folder. A PROMPT starts the session with that task. When you pipe text into hob, it reads the prompt from stdin. hob --help and hob <command> --help print the same information.
Sessions
| Flag | What it does |
|---|---|
-c, --continue |
Resumes the last session in this folder. |
-r, --resume <ID> |
Resumes one session by its id. -s and --session are other names for it. |
--fork-session |
Forks the session that -c or -r loads, under a new id. |
--session-id <ID> |
Writes the run under an id that you choose, unless a session with that id exists. |
See Sessions.
Model and prompt
| Flag | What it does |
|---|---|
-m, --model <SPEC> |
The model, as provider/model-id. Default: the model that you used last, then default_model in the config, then a model that hob finds a key for. |
--system-prompt <TEXT> |
Replaces the system prompt. |
--append-system-prompt <TEXT> |
Adds text to the end of the system prompt. |
--autoreview[=LEVEL] |
Starts each session of this launch with autoreview on, at LEVEL (base or full) if you give one. |
Print and SDK mode
| Flag | What it does |
|---|---|
-p, --print |
Runs the prompt with no TUI, and exits. Compatible with Claude Code’s --print. |
--output-format <FORMAT> |
The output of --print: text (default), json, or stream-json. |
--input-format <FORMAT> |
text (default), or stream-json for SDK mode. |
--verbose |
Adds every message of each turn to the output of --print. |
--image <PATH> |
Attaches an image to the prompt of --print. You can repeat it. |
--include-partial-messages |
Adds the partial messages of a streaming reply to the SDK output. |
--permission-mode <MODE> |
The permission mode, for SDK mode. |
--max-turns <N> |
The maximum number of agent turns. |
--exit-on-done |
Exits when the agent is done, for automation. |
--background-timeout <SECS> |
How long --print, SDK mode, and --exit-on-done stay up for background tasks after the input ends. Default: 600 for SDK mode and --exit-on-done. --print runs with background tasks off unless you set it. 0 turns background tasks off. At most one week. |
See Headless mode.
Tools and permissions
| Flag | What it does |
|---|---|
--allowed-tools <LIST> |
Gives the model only these tools, separated by commas. Takes snake_case or Claude Code’s PascalCase names. An unknown name is an error. --allowedTools is another name for it. |
--disallowed-tools <LIST> |
Removes these tools, separated by commas. --disallowedTools is another name for it. |
--yolo |
Skips all permission prompts. Deny rules still apply. --dangerously-skip-permissions is another name for it. |
--trust |
Loads the project’s .hob config for this run, with no question and no saved answer. For containers and CI. Use it only on a project that you trust. |
Startup
| Flag | What it does |
|---|---|
--no-commands |
Skips the custom commands in .hob/commands, .claude/commands, and the other command folders. |
--no-plugins |
Skips your init.lua files, global and project, but keeps the built-in plugins, so the tools and the default keys still work. Use it to recover from a broken init.lua. |
--no-jit |
Runs plugin Lua on the interpreter, with full debug information. |
--profile <PATH> |
Writes the execution trace to this new file, and prints its report on exit. hob does not overwrite a file. |
-V, --version |
Prints the version. |
Commands
hob auth
| Command | What it does |
|---|---|
hob auth login [PROVIDER] |
Signs in to a provider, such as openai, xai, or zai. Without a provider, hob asks which one. |
hob auth logout <PROVIDER> [--account <ACCOUNT>] |
Removes the saved credentials of a provider. With several saved accounts, --account names the one to remove. |
hob auth default <PROVIDER> <ACCOUNT> |
Picks the saved account that new sessions start on. |
hob auth status |
Shows the sign-in state of every provider. |
See Accounts.
hob session
| Command | What it does |
|---|---|
hob session list [-g] [--json] |
Lists the sessions of this folder. -g lists every project, --json prints one JSON array. |
hob session delete <ID> [-f] |
Deletes a session. -f skips the question. |
hob session export <ID> |
Writes a session to stdout as a portable JSON transcript. |
hob session import [FILE] |
Stores a JSON transcript as a new session in this folder, and prints its id. Reads stdin without a file, or with -. |
hob config
hob config example prints a full init.lua with notes, with every setting commented out. It includes the options of the bundled plugins, and it does not read your config or write files. See Configuration.
hob config example | lessDo not redirect it over your init.lua: shell redirection overwrites the file.
hob trust
| Command | What it does |
|---|---|
hob trust add [PATH] [--yes] |
Trusts a project, so that hob loads its shared .hob config. Default: the current folder. |
hob trust remove [PATH] |
Removes a saved trust decision. |
hob trust list |
Lists the saved trust decisions. |
See Folder trust.
hob mcp
| Command | What it does |
|---|---|
hob mcp auth <SERVER> |
Signs in to an MCP server from your config. |
hob mcp logout <SERVER> |
Removes the saved OAuth credentials of an MCP server. |
Other commands
| Command | What it does |
|---|---|
hob models [--refresh] |
Lists every model that you can use. --refresh fetches the models.dev catalog again, instead of the copy of the last 24 hours. |
hob update [-y] [--no-color] |
Installs the newest release. -y skips the question. |
hob rollback |
Goes back to the version before the last update. |
hob acp [-m <SPEC>] [--yolo] |
Runs hob as an ACP (Agent Client Protocol) server over stdio. |
hob index <PATH> |
Runs the index tool on a file, so that you see what the model gets. |
hob prompt [VARIANT] [--plan] [--tools [--names]] |
Shows the system prompt (system, research, or general), or the tool definitions as JSON. --plan adds the plan mode reminder. --names lists only the tool names. |
hob migrate xdg |
Moves ~/.hob/ to the XDG folders. hob also does this on startup. |
hob migrate providers |
Prints a prompt that ports old provider scripts to Lua plugins. |
Ignored flags
hob accepts these Claude Code flags so that the existing callers do not break. It prints warning: --<flag> is accepted but ignored and does nothing else with them:
--fallback-model, --settings, --setting-sources, --add-dir, --strict-mcp-config, --include-hook-events, --mcp-config, --tools, --betas, --max-thinking-tokens, --effort, --json-schema, --max-budget-usd, --thinking, and --thinking-display.
--permission-prompt-tool is accepted for compatibility and used in SDK mode.