Skip to main content

Settings & dials

The Settings view is where the harness's global behaviour lives. Most of it has reasonable defaults; this page is the reference for when you want to change them.

Where settings live​

Settings live at ~/.kenaz/harness/<env>/ (where <env> is prod for standard installs). The Settings view edits them; you can also edit the underlying files while Kenaz is closed.

The Settings nav​

The Settings view is organised into six groups in the left rail:

App​

  • General — default provider, model, and per-session preferences.
  • Account — Fleet identity; shows signed-in status when connected to Fleet.
  • Updates — update channel (stable / preview), auto-check toggle.
  • Flags — feature flags that can be toggled without a restart.
  • Health — live status of providers, MCP servers, and background services.

Authoring​

  • Compaction — context-window compaction settings: trigger threshold, provider used for summarisation, verbatim-message buffer after a compaction.
  • Slash Commands — create, edit, and delete user-defined slash commands. See Slash commands.
  • Workflows — manage saved workflow definitions. See the Workflows view for running them.
  • Hooks — list, enable/disable, and edit hooks. See Hooks.

Runtime​

  • Tasks — background task budget and behaviour when the task limit is hit.
  • Scheduled Chats — recurring chat schedules (start time, recurrence, session template).

Integrations​

  • Providers — add and configure LLM providers (API keys, base URLs, model lists). Same as the dedicated Providers view.
  • Bundles — manage skill/command bundles installed from external sources.
  • Secrets — inventory of OS-keychain entries Kenaz manages; rotate or wipe individual credentials. See Secret store.
  • LLM Routing — route specific request types (compaction, embedding, tool-use) to different providers.

Security​

  • Permissions — Bash, Filesystem, Credentials, and Tools permission families. Same as the dedicated Permissions view. See Permissions.
  • Policy — Cedar policy editor for fine-grained access rules.
  • Audit — audit log retention and export. See Audit log.

Privacy​

  • Crash Reporting — opt-in/out of automated crash reports.

A few defaults worth knowing​

  • ⌘N / Ctrl+N — new session
  • ⌘F / Ctrl+F — search
  • ⌘, / Ctrl+, — open Settings
  • ⌘\ / Ctrl+\ — toggle left rail