Your first session

Start hob in a project, pick a model, give it a task, and learn the keys that you use every day.

Start hob

Run hob in the folder of your project:

Terminal
hob

To give the first task on the command line, put it after hob:

Terminal
hob "explain how the config is loaded"

hob reads the instruction files of the project, such as AGENTS.md and CLAUDE.md, from the Git root down to the current folder. See Context.

Pick a model

hob starts with the model that you used last, then the default_model of your config, then a model of a provider that it finds a key for.

  • Ctrl+L or /model opens the model picker.
  • hob -m anthropic/claude-sonnet-4-6 starts with one model. A model spec is provider/model-id.
  • hob models lists every model of the providers that you can use.

The status bar always shows the model, the tokens, and the cost of the session. /usage breaks them down by model.

Build mode and plan mode

hob starts in build mode: it reads, edits, and runs commands to do the task.

Press Shift+Tab to switch to plan mode. In plan mode hob only writes a plan file, so you can agree on the plan before it changes code. Ctrl+T shows the plan, and Ctrl+O opens it in your editor. Press Shift+Tab again to go back to build mode.

Permissions

hob asks before a tool call that your rules do not allow yet. hob reads a shell command with tree-sitter, so git diff && rm -rf build asks for git and for rm, not only for git.

/yolo turns the prompts off for the session, and hob --yolo starts with them off. Deny rules still apply.

Keys for every day

Key What it does
Enter Sends the prompt.
Shift+Enter Starts a new line.
/ Opens the command palette.
Esc Esc Cancels the agent while it runs. When it is idle, rewinds to an earlier prompt.
Ctrl+B Moves a slow command or subagent to the background. hob works on.
Ctrl+P Opens the session browser.
Ctrl+X Opens the subagents of the session.
Ctrl+F Searches the messages.
Ctrl+G Edits the prompt in your editor.
Ctrl+H or /? Shows every key.
Ctrl+C Clears the input, or quits.

Start a line with ! to run a shell command yourself, for example !git status. With !!, hob does not see the command or its output.

To attach an image, paste it with Ctrl+V, or paste the path of the image file.

See Keybindings for every key, and Commands for every slash command.

Come back later

hob saves each session. To go back to one:

  • hob -c resumes the last session in this folder.
  • hob -r <id> resumes one session.
  • Ctrl+P in hob, or /resume, browses the sessions.

See Sessions.

Next steps

  • Turn on autoreview, so that hob reviews and repairs its own changes.
  • Change the settings in ~/.config/hob/init.lua. See Configuration.
  • Read how hob keeps the context small, in Context.

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"