Skip to content

Settings

Generated from the code by apps/docs/scripts/reference.mjs: edit the source, not this page.

Every setting, by plugin, as Settings shows it and wisp.yml sets it (settings: with the key). The default applies until you change it.

wisp.accounts

Key Type Default What it does
accounts.updateCheck bool true Check for newer harness versions: once a day, wisp asks npm for the latest Claude Code, Codex and opencode (npm then knows which of them you have)

wisp.automations

Key Type Default What it does
automations.webhookTriggers bool false Webhook triggers: other services may start this computer’s webhook triggers (POST /api/triggers/ with its secret)

wisp.budget

Key Type Default What it does
budget.drainWatch bool false Drain watch: tell the phone when a plan moves much faster than usual for the same work
budget.limitHold off · 80 · 90 · 95 "90" Ask near the limit: before a task would take a usage window past this percent, ask first (automations wait for the reset)
budget.liveLimits bool false Check Codex while work waits: read its usage every 10 minutes while work waits for its plan (spends nothing)
budget.silentStop off · 1 · 2 · 4 · 8 "off" Stop a run silent for: stop a run with no output for this many hours (a run silent 30 minutes while its plan moves is always told to your phone)
budget.spareCard bool true Spare allowance: say on home when a weekly window resets within a day with a fifth or more left
budget.windowNotice bool true Window notices: say when a usage window changed length or resets early

wisp.channels

Key Type Default What it does
channels.acceptChannels bool false Accept tasks from channels: messages routed here through wisp Cloud (“on this computer …”) may start tasks. Switch it on at this computer.
channels.project string "" Default project: where a task from a channel (Slack, Discord, Telegram, email) runs when its message names none (‘’: the last used)

wisp.crew

Key Type Default What it does
crew.tint bool true Crew tint: with the crew rail, the task list takes a very light tint of the colour of the member you pick.

wisp.events

Key Type Default What it does
events.sinks json [] Event sinks

wisp.git

Key Type Default What it does
git.maskEnvFiles bool true Hide .env values: what a task shows of a .env file (its output, edits, blocks, Changes) leaves wisp as dots until you reveal one
git.cloneDir string "" Where a pasted repo URL is cloned (‘’: the first of ~/code, ~/dev, ~/Developer, ~/projects… that exists, else ~/code)

wisp.grid-client

Key Type Default What it does
grid-client.previews bool false Show local pages in previews

wisp.learn

Key Type Default What it does
learn.enabled bool true Learn from your tasks: a short retro after each quiet task, kept as preferences and lessons later tasks follow

wisp.machine

Key Type Default What it does
machine.memoryFloor off · 10 · 15 · 20 · 25 Automations wait while free memory is under this percent
machine.cpuCeiling off · 100 · 150 · 200 Automations wait while the CPU stays over this percent of a core per core
machine.maxRuns off · 4 · 6 · 8 · 12 · 16 · auto Runs at once before automations wait
machine.batteryHold off · 20 · 40 On battery under this percent, check-ins and the crew queue wait

wisp.review

Key Type Default What it does
review.harness off · other · claude · codex · antigravity · copilot · opencode · cursor · grok "off" Review by another harness

wisp.runtime

Key Type Default What it does
runtime.retentionDays int 0 Days a finished task stays in the list before it’s archived (0: always)
runtime.leanRuns off · on · all "on" Lean Claude Code runs (no telemetry or update checks, and no claude.ai connectors): on, only wisp’s own side runs; all, every run; off, none
runtime.apps bool true Interactive answers: agents may answer with a small app
runtime.watch bool true Watch agents work: agents may open what they built in wisp’s browser to check it
runtime.blocks bool true wisp blocks: answers come as cards (off: plain markdown)
runtime.subagentModel task · haiku · sonnet "task" The model Claude Code’s subagents run on (task: the task’s own)
runtime.projectOrder json [] Your project order (names): the chips, New task’s row and the Projects list show them so; drag to change it
runtime.subagents json [] The team new tasks start with: [{ name, agent, model?, effort?, use? }] (New task pre-fills it; a task’s own team wins)
runtime.auto bool false Auto: wisp picks the harness, model and thinking level for each task. Off until it’s reworked (the owner, 2026-11-17): the one switch; the app hides Auto while it’s off
runtime.launch json {} New task’s last pick: { agent, models: { : model }, labels: { : name }, efforts: { : level } }; a task that names no harness runs on its agent
runtime.teams json [] Delegate’s saved teams (presets): [{ id, name, members: [{ name, agent, model?, effort?, use?, count?, machine? }] }]; Presets picks one, Save as preset keeps one
runtime.limitWait bool false Wait for the reset: a task at its usage limit carries on by itself after the reset, in the same conversation
runtime.followUp interrupt · queue "interrupt" A follow-up while a task works: interrupt it, or queue after it
runtime.setupAnswerSets json [] The API keys’ capability sets (custom:) you let answer an agent’s setup cards (ADR-0113): none unless you list them

wisp.settings

Key Type Default What it does
settings.timeZone string "" Time zone: the one scheduled times are read in, an IANA name like Europe/Zurich (the app sets it from your device)
settings.editor string "vscode" The editor files open in (vscode, cursor, windsurf, zed, idea, none)
settings.notify on · off "off" Desktop notifications when a task needs you or finishes
settings.readTimes on · off "on" Read times in prompts: a prompt that starts with a time (“in 5 min …”, “tomorrow at 9 …”) is scheduled for then
settings.transcript on · off "off" Open tasks on their transcript instead of the answer

wisp.ship

Key Type Default What it does
ship.fixConflicts bool false Fix merge conflicts by itself: when a task’s PR has conflicts, its agent is asked to fix them without waiting for you

wisp.stuff

Key Type Default What it does
stuff.panes string "" Panes: @task or @home, comma separated

wisp.termctx

Key Type Default What it does
termctx.enabled bool true Terminal context: wisp in a terminal may attach what just happened there

wisp.terminal

Key Type Default What it does
terminal.terminal string "wisp" Open tasks in: wisp, one of this computer’s terminal apps (its id) or custom
terminal.command string "" Take over with a custom command ({cmd} is the agent’s resume command)
terminal.terminalSessions on · off "off" Babysitting mode: each task opens straight in the agent’s own terminal

wisp.threads

Key Type Default What it does
threads.compactAudit bool false Check compactions: after a compaction, wisp asks a copy of the conversation what it still remembers of the task’s Notes and reminds the agent of what it lost (one short extra run each)

wisp.update

Key Type Default What it does
update.updateChannel stable · beta · nightly "stable" Update channel

wisp.worktrees

Key Type Default What it does
worktrees.cleanup off · 3 · 7 · 14 · 30 Idle worktrees go after this many days (unset: 7, counted from when wisp got it)
worktrees.max off · 20 · 40 · 80 "40" Worktree folders kept before the oldest idle ones go
worktrees.onDone ask · remove · keep "ask" When a task is done, its worktree folders
worktrees.projectAsk on · off "on" Ask before trusting a new project’s setup scripts
worktrees.worktree on · off "on" New tasks run in their own worktree by default