Skip to content
TyrnBeta

Settings

Tyrn has a Settings window for agents and models, and a settings.json file for everything else.

The Settings window

Click Settings in the sidebar footer, or run tyrn: open settings from the command palette. The pages are grouped:

  • Agents: Harnesses, Roles, Plugins, Connectors, Subagents, Assistant, Autocomplete.
  • Inference: Subscriptions, Usage-based, Local.
  • Editor settings: themes, fonts, languages, key bindings and the rest of the editor.

settings.json

Your user settings are in ~/.config/tyrn/settings.json. Settings in a project can override them in .tyrn/settings.json at the project root.

Files are JSON with comments. Edit them in Tyrn and they apply as soon as you save.

Tyrn settings

Key Default What it does
tyrn.daemon_path "" Path to the Tyrn backend binary. Empty uses the one bundled in the app.
tyrn.socket_path "" Path to the backend socket. Empty uses ~/.tyrn/run/daemon.sock.
tyrn.assistant.harness null Harness behind Explain, Rewrite Selection and Generate commit message. Off until set.
tyrn.assistant.role null Role to use for those actions.
tyrn.assistant.timeout_seconds 120 How long an assistant action can run.
tyrn.harness_defaults {} Per-harness defaults for new sessions, keyed by harness id. Edit them in Settings > Agents > Harnesses.
edit_predictions.provider "none" Set to "tyrn" to turn on autocomplete.
edit_predictions.tyrn.model null Model behind autocomplete, as "provider/model" or "provider:account/model".
edit_predictions.tyrn.next_edit_model null Optional model for multi-line edits and jumps. Falls back to model.
edit_predictions.tyrn.max_output_tokens 256 Most tokens a completion can produce.
edit_predictions.tyrn.debounce_ms 150 Pause after typing before a request is sent.
edit_predictions.tyrn.deadline_ms 2500 Give up on a completion after this long.
edit_predictions.tyrn.next_edit_deadline_ms 5000 Give up on a next-edit prediction after this long.
edit_predictions.mode "eager" "eager" shows predictions inline. "subtle" shows them while you hold a modifier key.
edit_predictions.disabled_globs secrets and config files Files that never get autocomplete. Defaults cover .env*, *.pem, *.key, *.cert, *.crt, .dev.vars, secrets.yml and Tyrn settings and keymap files.
auto_update true Check for and install updates. Update checks send only version, platform and architecture.
server_url "https://tyrn.dev" Server used for update checks and release notes. Set to "" to turn update checks off.
telemetry.metrics false Usage data. Off in this release.
telemetry.diagnostics false Crash reports. Off in this release.

Example:

settings.json
{
  "auto_update": false,
  "edit_predictions": {
    "provider": "tyrn",
    "tyrn": { "model": "provider/model" }
  },
  "tyrn": {
    "assistant": { "harness": "claude_code" }
  }
}