Settings
How hob's settings are organized, the highlights of each category, and per-project overrides.
Open settings with Cmd/Ctrl+, or from the command palette. The sidebar groups everything
into categories — the highlights are below. Search within Settings with Cmd/Ctrl+F.
Many fields are hidden until you turn on Advanced mode (a toggle in Settings). If you can't find a setting mentioned here, enable Advanced mode first.
Appearance
- Theme — eight color themes (hob style is the default), each with a dark and light variant. See Themes.
- Color scheme — Dark, Light, or System (follow the OS).
- Typography — separate prose and code fonts, base size, UI zoom.
- Thinking indicator — how agent reasoning is shown while it streams.
- Files & icons — file icon style and caret shape.
- Layout — UI zoom, code word-wrap, minimum columns, dim inactive panes, toolbar side, and toolbar button order.
- Onboarding — show the onboarding screen on startup.
Workspace
Workspace-level behavior plus several sub-areas: Remote access levels (see Remote access), Data retention (trash retention, default 7 days; advanced output-truncation controls), Activity (import conversations, hide workflows from Activity), Search (excluded file globs), and Advanced (system file picker, stash-pop behavior, Linux GPU controls).
Terminal
- Terminal theme — Auto (match the UI) or any built-in theme.
- New terminal view — command blocks or classic terminal.
- Output wrap mode, and advanced output-collapse controls.
Agent
The home for agent behavior, organized into sub-sections:
- Session Defaults — backend, model, and effort for new agent panes; default permission mode (ask vs. approve all); plan-approval mode; whether thinking is shown.
- Backend Profiles — named backend + model + effort combinations. See Agent accounts for running multiple Claude Code, Codex, or OpenCode profiles side by side with separate config directories.
- Claude Code / Codex / OpenCode — per-backend CLI path, extra flags, and environment.
- Agent file sync — keep
AGENTS.mdandCLAUDE.mdin sync. On by default using symlink mode, with copy fallback when symlinks are unavailable. - Managed hob instructions — keep hob's integration guidance in your agent files so agents can coordinate with panes and produce artifacts. On by default. See hob integration layer.
Issues & Plan
Defaults for issue-spawned agents (permission mode, start mode, backend/model) and plan behavior. See Issues.
Web
External-link behavior (open in your system browser or a web pane), web-pane proxy mode, shared global origins, and web data retention. The git platform connection (GitHub, Gitea, or Forgejo — auto-detected from your remote, with per-project token overrides) also lives here and powers remote issues and pull requests.
Updates
Version and update status, automatic update checks, and the release channel. (Some controls are managed by the store in App Store / Microsoft Store builds.)
Shortcuts
Opens the keyboard-shortcuts editor — see Keyboard shortcuts.
Project-specific overrides
Most agent settings, file-sync mode, git platform, and environment can be overridden per project from Project Settings. Project values take precedence over global defaults and travel with the project, so different repos can use different models, backends, or tokens.
Extra CLI flags and environment variables append to the global values rather than replacing them. A few settings (search excludes, hidden workflows, git platform) are project-only.
You can also give each project a custom icon in the project switcher.