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

Terminal
hob config example | less

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

Keyboard shortcuts

Go to

On this page

  • jkNext or previous section
  • 12…The section with that number
  • cCopy the install command
  • iDownload
  • dDocs
  • []Previous or next page

Anywhere

  • ?Show or hide this list
  • EscClose, or stop a "g"