Skip to content

Settings & overrides

Harmonic settings live at three levels: global defaults for the whole instance, per-workspace settings for one repo, and per-ticket settings for a single piece of work. Lower levels inherit from higher ones unless you set your own value, so you can steer one ticket or a whole board with the same handful of controls.

Global (the settings page, header icon) — things that belong to the whole instance:

  • the harnesses and their models (see Harnesses),
  • model prices (so cost is accurate),
  • the verification checks that run before a merge (commands and named critics, in the order you set),
  • notification channels,
  • permission rules,
  • security (the operator password),
  • the machine-wide limit on how many agents run at once.

Per workspace — things about one repo:

  • its name and folder,
  • whether its tracker is on and how often it polls,
  • whether the Auto-Runner is on for it,
  • and its defaults for new tickets (harness, model, isolation, priority) and how many agents it may run at once.

Per ticket — override any of those defaults for a single ticket when it needs something different.

A workspace or ticket uses the level above it unless you give it its own value; “reset to default” puts it back to inheriting. That’s what makes bulk changes easy:

  • Change a workspace’s default model, and every ticket that hasn’t pinned its own model follows, so you can re-point a whole board in one edit.
  • Pin a model on a single ticket, and only that ticket changes.

You can adjust a ticket’s settings right up until it starts running, so you can re-point something that’s still waiting in the queue.

Each workspace has a cap on how many agents it runs at the same time, and there’s a machine-wide ceiling no workspace can exceed, so one busy repo can’t swamp the host. Separately, a master switch in the header pauses or resumes all automatic running across every workspace at once, your one-click way to grab the wheel.

While you’re chatting with an agent in a Conversation, it asks before it edits a file or runs a command. If you’d rather not be asked every time, a permission rule lets an agent skip the prompt for a kind of action (reading, editing, running, fetching) in a given workspace. Rules are listed on the settings page and you can remove one whenever you want.

Harmonic shows a running dollar cost on every agent’s work, based on a price per model. It already knows the models the built-in harnesses use. If you add a model it doesn’t have a price for, add that price too; otherwise its work shows as cost-incomplete rather than a misleading zero.