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 |