Customizing
Settings Configure hob to match your workflow.
Access settings from the menu bar or the gear icon in the sidebar. Settings are organized into categories.
Setting Description Default Theme Color theme for the UI Ink Theme mode Dark, light, or follow system Dark Icon theme File icon style (layered, stroke, filled) Layered Agent icon Agent avatar style (cursor, sparkle, robot) Cursor UI zoom Scale the entire interface (50% - 200%) 100% Caret shape Text cursor style (bar, block, underscore) Bar
Setting Description Default Code word wrap Wrap long lines in code views Off Word wrap mode Wrap at word or character boundaries Word Output collapse threshold Line count before auto-collapsing output Configurable Show turn time Display time markers between agent turns On Diff merge controls Show accept/reject buttons in diff views On
Setting Description Default backend Agent CLI to use (Claude Code, Codex, OpenCode) Default model AI model for new agent panes Default effort Speed/quality tradeoff for new agents Default permission mode How tool executions are handled Thinking blocks Show agent reasoning by default
Setting Description Shell Default shell program (bash, zsh, powershell) Terminal theme Match UI theme or override separately
Setting Description Roam Enable mobile/LAN access Relay Enable internet access via connect.hob.dev Allow non-local Accept connections from non-localhost addresses
Setting Description Trash retention Days before auto-purging deleted items Min pane count Minimum panes per workspace (1 or 2)
Setting Description Auto-update Check for and apply updates automatically
Many settings can be overridden per-project. Project settings are stored in .hob/project.json and take precedence over global defaults. This is useful for setting different agent models, backends, or environment configurations per project.
How is this guide? 