Commands
Generated from the code by
apps/docs/scripts/reference.mjs: edit the source, not this page.
Every command a plugin contributes. The app, the TUI, the CLI (wisp <plugin> <verb>), the SDKs, MCP tools and other plugins all call these. Reads marks a command that changes nothing.
wisp.accounts
wisp.accounts host: accounts, sign-in, harness watch (before:run), harness disk, live limits, usage, allowance
| Command | What it does | Reads |
|---|---|---|
accounts.list |
A harness’s accounts | yes |
accounts.harnesses |
Every harness that can have several accounts, with its watch | yes |
accounts.add |
Add another account | |
accounts.update |
Rename, set the kind, or move an account | |
accounts.remove |
Sign an account out and forget it | |
accounts.watch |
What wisp pinned of a harness’s program | yes |
accounts.watch.trust |
Trust this version of a harness | |
accounts.watch.ask |
Ask before running a changed harness | |
accounts.login |
A sign-in as it stands | yes |
accounts.login.start |
Sign in with the CLI’s own login | |
accounts.login.input |
Paste back the sign-in code | |
accounts.login.cancel |
Stop a sign-in | |
accounts.login.status |
Signed in, and as whom | yes |
accounts.logout |
Sign out with the CLI’s own sign-out | |
accounts.keys |
Which providers have an API key | yes |
accounts.keys.set |
Save a provider’s API key | |
accounts.keys.remove |
Remove a provider’s API key | |
accounts.keys.test |
Test a provider’s API key | |
accounts.install |
Install a harness wisp can install itself | |
accounts.upgrade |
Update a harness to its latest version | |
accounts.recheck |
Detect every harness again | |
accounts.cool |
Mark an account at its usage limit until its reset (launches you start skip it) | |
accounts.limits |
Read an account’s usage windows | yes |
wisp.automations
triggers, watchers, recipes, cron schedules, inbound webhooks
| Command | What it does | Reads |
|---|---|---|
automations.tasks |
Declared tasks | yes |
automations.task.set |
Declare a task | |
automations.task.remove |
Remove a declared task | |
automations.task.run |
Run a declared task | |
automations.trigger.ls |
Triggers | yes |
automations.trigger.fire |
Fire a trigger | |
automations.trigger.test |
Test a trigger (dry run) | yes |
automations.trigger.log |
A trigger’s deliveries | yes |
automations.trigger.push |
Send triggers an event | |
automations.trigger.approve |
Approve a trigger’s job | |
automations.trigger.resume |
Resume a paused trigger | |
automations.trigger.switch |
Switch a trigger off or on | |
automations.trigger.remove |
Remove a trigger | |
automations.release |
Rows held for a harness’s plan stop saying so (its plan reset early) | |
automations.sources |
Trigger sources | yes |
wisp.budget
usage windows, Automations stop at, banked resets, the before:run budget guard, compare metrics
| Command | What it does | Reads |
|---|---|---|
budget.view |
An account’s usage windows | yes |
budget.compare |
Tokens per turn by account, per model | yes |
budget.planWindows |
Each usage window this period and the tasks’ parts of it | yes |
budget.hold |
What holds an account’s unattended work | yes |
budget.ask |
Ask near the limit: the usage window a send would take past your line, before it’s made | yes |
budget.resetAt |
When an account at its usage limit can run again | yes |
budget.record |
Record an account’s usage windows | |
budget.dismissDrain |
Drain watch: hide an account window’s card until a later run shows it again | |
budget.dismissNotice |
Hide a window’s notice until that window changes again | |
budget.setStop |
Automations stop at |
wisp.channels
wisp.channels: the hub every way of reaching wisp from outside goes through (plan §6.11.3): the channel and notification kinds
| Command | What it does | Reads |
|---|---|---|
channels.view |
Which channels are on | yes |
channels.update |
Change a channel’s settings | |
channels.test |
Send a test to a channel, or to every channel that’s on | |
channels.status |
How each channel is set up (Settings → Phone): on or off, connected, what it still needs; secrets only as saved or not | yes |
channels.setup |
Set up a channel (ntfy, Telegram, Slack, Discord, GitHub, email): switch it on or off, save its tokens (kept in secrets.json) and settings | |
channels.send |
Send a notice | |
channels.notify |
Notify about a task | |
channels.act |
Act on a task from a channel | |
channels.inbound |
A message the grid held | |
channels.routed |
A message the grid routed | |
channels.rotate |
Replace a channel’s private URL | |
channels.extra |
A channel’s extra view | yes |
channels.refresh |
Read the channels again |
wisp.cli
the command-line frontend: verbs generated from the command catalogue, terminal block renderers, live attach
| Command | What it does | Reads |
|---|---|---|
cli.catalogue |
The commands you may run, with their arguments | yes |
wisp.connectors
The MCP servers agents get: the connector resource kind, what each run gets, and Settings → Connectors (add, test, import from the harnesses’ configs, OAuth sign-in).
| Command | What it does | Reads |
|---|---|---|
connectors.list |
Every connector, the servers found in the harnesses’ configs, and the reach | yes |
connectors.add |
Add a connector (its secrets go to the secrets file) | |
connectors.update |
Change a connector, or switch it on or off | |
connectors.remove |
Remove a connector and its secrets | |
connectors.test |
Start a connector and list its tools | |
connectors.import |
Add servers found in the harnesses’ own configs, or hide them | |
connectors.signin |
Sign in to a remote connector (OAuth): the page to open | |
connectors.oauthFinish |
Finish a connector’s sign-in | |
connectors.signout |
Sign out of a connector | |
connectors.agent.list |
The user’s connectors, as a task’s agent reads them (wisp_connectors) | yes |
connectors.agent.add |
Add a connector from a task, key names only (wisp_connector_add) | |
connectors.agent.signin |
What a connector needs from the user before it works (wisp_connector_signin) | yes |
connectors.call |
Call one tool of a remote connector, with its own sign-in (the issue picker lists Linear and Jira through them) |
wisp.crew
crew members: schedules, check-ins, jobs, mentions, notebooks, sharing
| Command | What it does | Reads |
|---|---|---|
crew.wake |
Wake a crew member: a job, because something happened | |
crew.wakeMentions |
Wake the crew members a text mentions | |
crew.list |
Your crew | yes |
crew.get |
A member and their jobs | yes |
crew.layout |
Where each member sits on the Org page | yes |
crew.set_layout |
Move members on the Org page | |
crew.create |
Add a member | |
crew.adopt |
Add a task to the crew | |
crew.update |
Change a member | |
crew.remove |
Let a member go | |
crew.detach |
Make a spell’s member yours | |
crew.ask |
Ask a crew member in a task: their answer lands under your message | |
crew.reply |
Reply to a crew member’s answer in a task: the same job carries on | |
crew.assign |
Give a member a job | |
crew.checkin |
Check in now | |
crew.stats |
Each member’s track record | yes |
crew.graph |
Who wakes whom | yes |
crew.export |
Share members as a crew file (refused while it holds a secret) | yes |
crew.import |
Review a crew file, or add its members (paused) | |
crew.share |
Share members or the whole crew as a link (wisp Cloud; refused while it holds a secret) | |
crew.kit |
Skills and instructions a member’s kit can take | yes |
crew.agent.kit |
Propose skills or instructions for a member’s kit (wisp_crew_kit) | |
crew.agent.add |
Add a member, or the members a shared link or crew file holds, paused (wisp_crew_add) | |
crew.agent.list |
The crew, or one member in full, as an agent reads it (wisp_crew) | yes |
crew.agent.edit |
Change a member: only the fields given; remember adds notebook lines (wisp_crew_edit) | |
crew.agent.remove |
Remove a member; a member’s own job can’t remove itself (wisp_crew_remove) |
wisp.events
The durable event log from outside the process: tail, why, retry, the catalogue, the events topic, MCP wisp_events, and sinks (a signed webhook) (ADR-0044)
| Command | What it does | Reads |
|---|---|---|
events.tail |
What happened: durable events by type, subject or since | yes |
events.why |
What caused an event: its chain, root first | yes |
events.retry |
Deliver a parked event again | |
events.parked |
Events a subscription gave up on, and why | yes |
events.ls |
Every event type wisp emits | yes |
events.sinksStatus |
Where events are forwarded, and how each sink is doing | yes |
events.resume |
Resume a paused sink |
wisp.factory
software factories: a task through stations (spec you approve, build, checks that are commands, review by a vote, ship a PR you merge), looped back to build with a limit (ADR-0114)
| Command | What it does | Reads |
|---|---|---|
factory.list |
Factories (declared) | yes |
factory.names |
Factories a task can run through | yes |
factory.set |
Add or change a factory | |
factory.remove |
Remove a factory | |
factory.stop |
Stop a factory run |
wisp.git
Git for every other plugin: repo handles (git.service@1), status, diffs from the merge-base, worktrees, staging and commits. Every git call runs async through the proc service.
| Command | What it does | Reads |
|---|---|---|
git.status |
A folder’s git status | yes |
git.changes |
What the work changed since its base | yes |
git.revert |
Put a file or hunk back as the base had it | |
git.stage |
Stage or unstage a file or hunk | |
git.commit |
Commit what’s staged | |
git.tools |
Is git installed, and gh signed in | yes |
git.clone |
Clone a repo | |
git.origin |
A folder’s repo (its origin), to run its task on another computer | yes |
git.githubRepos |
Your GitHub repos (gh’s sign-in), newest first, minus the projects here: Projects’ click to clone | yes |
git.checkout |
This computer’s checkout of a repo: one already here, else a clone | |
git.restoreTurn |
Put a task’s folder back as it was before one of its turns |
wisp.goal
goals: rounds, verdicts, judges, stalls
| Command | What it does | Reads |
|---|---|---|
goal.set |
Set, change or clear a task’s goal | |
goal.pause |
Pause a task’s goal: no judging until it resumes | |
goal.resume |
Resume a task’s paused goal | |
goal.drop |
Drop a task’s goal | |
goal.check |
Judge a task’s goal now, on its last answer | |
goal.declared |
The goals declared by name (goals: in a formula) |
wisp.grid-client
Sign in to a wisp Grid (RFC 8628), the grid and grid-tunnel transports, this computer’s tunnel, and wisp Cloud as a share destination (ADR-0010, 0038, 0041)
| Command | What it does | Reads |
|---|---|---|
grid-client.signin |
Sign in to wisp Cloud (or another grid): adds an account and makes it current | |
grid-client.sandbox |
Make a sandbox on the grid, as a machine | |
grid-client.sandboxes |
Your sandboxes on the grid | yes |
grid-client.sandboxRemove |
Delete a sandbox (its box and home) | |
grid-client.sandboxInfo |
Sandboxes on the grid: whether it makes them, their sign-ins and env names | yes |
grid-client.sandboxLogin |
A sign-in every sandbox starts with, sealed on the grid | |
grid-client.sandboxLogout |
Take a sandbox sign-in off the grid | |
grid-client.sandboxEnv |
An env var every sandbox gets (empty: taken out) | |
grid-client.teams |
Team spaces on the grid: list, make, show, add or remove a member | |
grid-client.signinStatus |
How a sign-in is going | yes |
grid-client.signinCancel |
Stop a sign-in | |
grid-client.status |
Signed in where, and this computer on the grid | yes |
grid-client.signout |
Sign out of the current grid account | |
grid-client.accounts |
The grid accounts signed in to here, the current one marked | yes |
grid-client.accountSwitch |
Make another signed-in grid account the current one | |
grid-client.accountRemove |
Sign out of one grid account (its cloud box and computers leave Machines) | |
grid-client.computer |
Turn this computer on or off on the grid | |
grid-client.shares |
What I’ve shared through wisp Cloud | yes |
grid-client.access |
Change who may open a share, its expiry, or its place in the gallery | |
grid-client.revoke |
Stop sharing | |
grid-client.fetch |
Open a share link | yes |
grid-client.imported |
Record a share taken in (for update available) | |
grid-client.updates |
Imported shares with an update | yes |
grid-client.keys |
Your API keys for scripting your cloud wisp (never the keys themselves) | yes |
grid-client.keysCreate |
Make an API key for scripting your cloud wisp, shown once | |
grid-client.keysRevoke |
Revoke an API key: anything using it stops at once | |
grid-client.reply |
Report a routed task back to the chat it came from |
wisp.history
A repo’s agent history in .wisp/: track, blame, offers, resume requests, context injection (ADR-0033, 0042)
| Command | What it does | Reads |
|---|---|---|
history.track |
Save a task into its repo’s .wisp/ | |
history.save |
Save to repo (an offered task) | |
history.untrack |
Take a task out of the repo’s history | |
history.blame |
Which task made this | yes |
history.resumeRequest |
Ask to resume an earlier task | |
history.resumeAnswer |
Approve or deny a resume request | |
history.requests |
Resume requests | yes |
history.list |
The repo’s committed agent history (the Repo tab, wisp ls –repo) | yes |
history.report |
A tracked task’s report and what was asked | yes |
wisp.issues
issues to start a task from: a project’s GitHub issues (gh), the Linear and Jira issues assigned to you
| Command | What it does | Reads |
|---|---|---|
issues.list |
List issues to start a task from | yes |
wisp.later
follow-ups and reminders scheduled on tasks, For later, /after plans
| Command | What it does | Reads |
|---|---|---|
later.add |
Schedule a follow-up or a reminder on a task | |
later.park |
Save a task for later, or unsave it | |
later.list |
What is scheduled on a task | yes |
later.edit |
Another time or text, or send it now | |
later.cancel |
Cancel what is scheduled | |
later.done |
Mark done: the agent’s wake-ups go | |
later.plans |
Planned tasks and reminders | yes |
later.getPlan |
A plan | yes |
later.plan |
Plan a task or a reminder | |
later.editPlan |
Change a plan | |
later.cancelPlan |
Cancel a plan | |
later.nextAt |
The soonest thing that will run | yes |
later.tick |
Look for what came due | |
later.waitAtLimit |
Carry on once the usage window resets | |
later.agent.schedule |
The agent’s own wake-up (resume_later) | |
later.zone |
The user’s time zone |
wisp.learn
What wisp learns about how you work: preferences and lessons, globally and per project, from a retro of each quiet task; later tasks’ prompts carry them
| Command | What it does | Reads |
|---|---|---|
learn.view |
What wisp has learned: preferences and lessons, and the recent retros | yes |
learn.set |
Replace one list of what wisp has learned (global or a project’s) | |
learn.retro |
Learn from a task now: a retro of it, without waiting for it to go quiet |
wisp.lsp
wisp.lsp: language servers for the editor (definition, references, hover, diagnostics, rename, completion)
| Command | What it does | Reads |
|---|---|---|
lsp.ask |
Ask the task’s language server | |
lsp.install |
Install a language server |
wisp.machine
What agents cost this computer, the RAM/CPU and usage-limit holds, stopping what runs left behind, and Watch.
| Command | What it does | Reads |
|---|---|---|
machine.load |
What the RAM/CPU guard reads and holds | yes |
machine.read |
What agents cost this computer: memory, CPU, disk, leftovers | yes |
machine.stop |
Stop a process a task’s run left running | |
machine.fix |
File a fix for processes a run left running | |
machine.harness.clean |
Remove the harnesses’ crash dumps and stale files | |
machine.automations.pause |
Pause automations until a time (0 resumes them) |
wisp.machines
Peers, your other computers, over wisp’s sync protocol: the ssh and loopback transports, the mirrored task lists, commands routed to the owner with the same key, the machines.peers service
| Command | What it does | Reads |
|---|---|---|
machines.add |
Add a computer | |
machines.update |
Rename a computer or change how it is reached | |
machines.remove |
Remove a computer | |
machines.connect |
Connect to a computer | |
machines.disconnect |
Disconnect from a computer | |
machines.stop |
Stop wisp on a computer (or restart it) | |
machines.letIn |
Type the password once so this computer’s key is let in | |
machines.follow |
Watch an asleep computer without waking it | |
machines.recheckAgents |
Detect a computer’s coding agents again | |
machines.list |
Your computers and how each is doing | yes |
machines.get |
One computer and how it is doing | yes |
machines.sessions |
The tasks a computer shows, as last seen | yes |
machines.hosts |
Hosts in ~/.ssh/config | yes |
machines.discover |
Computers this one already knows how to reach | yes |
machines.reachable |
Can other devices reach this computer | yes |
machines.call |
A request to a computer’s wisp | |
machines.route |
Run a command on the computer that owns its row | |
machines.carry |
Copy the lead’s work onto a computer for a delegate (a copy under wisp’s own folder there) | |
machines.takeIn |
Take carried work into its copy (on the computer it was carried to) | |
machines.changes |
A carried copy’s changes since it came in | yes |
machines.send |
Pack a folder here and upload it raw to a computer’s route (a sandbox’s project) | |
machines.uncarry |
A lead’s delegate on a computer goes: its task and its copies there | |
machines.dropCopies |
Delete the copies a lead’s delegates got (on the computer they were carried to) | |
machines.bring |
A carried copy’s changes, into the lead’s folder here |
wisp.mcp
wisp.mcp host: the MCP server for agents and editors over POST /api/mcp and stdio, each tool a kernel command
| Command | What it does | Reads |
|---|---|---|
mcp.rpc |
One MCP JSON-RPC message | |
mcp.tools |
The MCP tools this caller is offered | yes |
mcp.session.set |
What a session’s run is, for its tools |
wisp.plugins
The plugin manager: which plugins this wisp has, switching them on and off (the plugin kind)
| Command | What it does | Reads |
|---|---|---|
plugins.list |
Which plugins this wisp has | yes |
plugins.setEnabled |
Switch a plugin on or off | |
plugins.install |
Install a plugin of yours from a folder or a git URL (off until you switch it on) | |
plugins.uninstall |
Remove a plugin you installed | |
plugins.trust |
Trust a plugin you installed (or take the trust back): it reloads | |
plugins.folder |
Where this wisp keeps your plugins (its home’s plugins folder) | yes |
plugins.ui |
What your untrusted plugins show in the app (their UI modules) | yes |
plugins.styles |
The part styles of the plugins that are on and trusted (themes), for the app’s @layer plugins | yes |
plugins.agent.list |
The plugins you have, in plain words, for an agent writing one (wisp_plugins) | yes |
plugins.agent.schema |
The reference for writing an untrusted plugin: manifest, kit descriptors, commands, examples (wisp_plugin_schema) | yes |
plugins.agent.data |
A sample of what a read-only command answers, for a plugin being written (wisp_plugin_data) | yes |
plugins.agent.check |
Check a plugin without installing it: what it does, or every problem (wisp_plugin_check) | yes |
wisp.push
wisp.push: the push transport for wisp.channels (phones paired by their own keys, notes sealed with HPKE, posted through the grid relay)
| Command | What it does | Reads |
|---|---|---|
push.pair |
Pair this phone for notifications: its relay handle and its own public key | |
push.unpair |
Stop sending notifications to a paired phone | |
push.devices |
The phones that get this wisp’s notifications | yes |
push.answer |
A choice or a reply from a notification, signed by this wisp |
wisp.resources
wisp as code: plan, apply and export every plugin’s resource kinds (wisp.yml)
| Command | What it does | Reads |
|---|---|---|
resources.kinds |
What this wisp can declare | yes |
resources.plan |
What applying a formula would change | yes |
resources.apply |
Apply a formula | |
resources.export |
Everything set up here, as a formula | yes |
resources.read |
Read a pasted formula: the resources it declares and the secrets it needs | yes |
resources.overlay |
A formula as one task’s overlay (nothing applied), and a task resolved under it with every name it gives checked | yes |
resources.write |
The setup as a formula’s text (Share setup) | yes |
resources.secretSet |
Set a secret a formula references as ${secret:NAME} (kept in secrets.json, never in a formula) | |
resources.secretRemove |
Remove a secret a formula references | |
resources.rename |
Rename a resource in place (wisp mv) | |
resources.refresh |
Take what wisp has as the baseline (–refresh-only) |
wisp.review
review by another harness: a task’s PR head read by a harness other than the author, the tests run again on it
| Command | What it does | Reads |
|---|---|---|
review.maybe |
Review the pull request with another harness | |
review.view |
The task’s review | yes |
wisp.router
Auto: picks a harness, model and effort per task (bandit), classifies limits
| Command | What it does | Reads |
|---|---|---|
router.view |
Settings → Auto and what it learned | yes |
router.set |
Change Settings → Auto | |
router.preview |
What Auto would run for a prompt | yes |
router.reset |
Forget what Auto learned | |
router.signal |
Something happened to a routed task | |
router.record |
A launch went out with a route |
wisp.runtime
Tasks (sessions), their turns and activity, the follow-up queue and the harness lifecycle
| Command | What it does | Reads |
|---|---|---|
runtime.create |
Start a task | |
runtime.followUp |
Send a task a follow-up | |
runtime.stop |
Stop a task’s turn | |
runtime.rename |
Rename a task | |
runtime.archive |
Archive or unarchive a task | |
runtime.markRead |
Mark a task read or unread | |
runtime.setState |
Set a task’s state | |
runtime.delete |
Delete a task | |
runtime.queue.edit |
Edit a queued follow-up | |
runtime.queue.sendNow |
Send a queued follow-up now | |
runtime.queue.merge |
Merge queued follow-ups into one | |
runtime.queue.text |
Change a queued follow-up’s text | |
runtime.release |
Release a held task | |
runtime.held |
Start or skip a task’s held turn | |
runtime.setMode |
Set the mode a task’s next turns run in | |
runtime.setLean |
Run a task’s turns lean (on, off, or none to follow Settings) | |
runtime.setAgent |
Set the harness a task’s next turns run on | |
runtime.forLater |
Save a task for later, or take it out | |
runtime.pin |
Pin a task in the list, or unpin it | |
runtime.queue.order |
Reorder a task’s queued follow-ups | |
runtime.queue.cancel |
Take a queued follow-up out | |
runtime.get |
A task | yes |
runtime.resumeCommand |
The command that resumes a task’s conversation in a terminal | yes |
runtime.list |
The task list | yes |
runtime.slots |
Plugins’ slots of every task | yes |
runtime.turns |
A task’s turns | yes |
runtime.activity |
A task’s activity | yes |
runtime.cold |
A large idle task’s prompt cache: gone cold or not, and what Compact now would cost | yes |
runtime.presentation |
A task’s presentation | yes |
runtime.setExt |
Set a plugin’s slot on a task | |
runtime.turn.setExt |
Set a plugin’s slot on a turn | |
runtime.note |
Add a note to a task | |
runtime.settle |
Settle a task that stopped | |
runtime.search |
Search tasks | yes |
runtime.agents |
The harnesses a task can run on | yes |
runtime.defaultModel |
The model a harness’s Default runs in a folder | yes |
runtime.card |
Add a card to the list | |
runtime.import |
Import tasks from another wisp home | |
runtime.ask |
An agent asks the user a question | |
runtime.answer |
Answer an agent’s question | |
runtime.setup.ask |
An agent asks the user to change their setup (a connector, the crew, a project): a card, run on Allow | |
runtime.unask |
Take back a question a plugin put on a task | |
runtime.pollAnswer |
Has the question been answered | yes |
runtime.approval |
A live approval of a tool call | |
runtime.approveBlocked |
Allow what the last turn’s permissions blocked | |
runtime.btw |
A side question on a copy of the conversation | |
runtime.btw.drop |
Drop a side question | |
runtime.probe |
Ask a copy of a task’s conversation something, answering only, kept nowhere | |
runtime.reveal |
Show an answer’s picture or video in its folder | |
runtime.unmasked |
Reveal one hidden .env value of a task’s turn | yes |
runtime.compact |
Compact the conversation | |
runtime.terminal |
Open a terminal task’s CLI | |
runtime.rerun |
Run a signed-out turn again | |
runtime.fork |
Fork the task from a turn | |
runtime.trial |
Try it two ways: run a task twice on one harness with one setting changed | |
runtime.trial.keep |
Keep one run of Try it two ways (the other is archived) | |
runtime.delegate |
Start subagents | |
runtime.results |
Subagents’ reports | yes |
runtime.quick |
One answer from a harness, outside any task | |
runtime.quickCancel |
Stop a quick run under way (its process tree killed) | |
runtime.signIn |
Rerun this turn when its sign-in lands | |
runtime.signInDone |
A sign-in finished | |
runtime.overage |
A turn billed past its plan | |
runtime.agent.sessions |
An agent lists the user’s tasks (wisp_sessions) | yes |
runtime.agent.watch |
An agent keeps a page beside its task (wisp_watch) | |
runtime.agent.session |
An agent reads a task (wisp_session) | yes |
runtime.agent.tag |
An agent tags its task with its topics (wisp_tag) | |
runtime.agent.blocks |
An agent reads the fields of answer blocks (wisp_blocks) | yes |
runtime.agent.stats |
An agent reads tool stats across the user’s tasks (wisp_stats) | yes |
runtime.agent.available |
An agent reads what it can run work on (wisp_available) | yes |
runtime.agent.task |
An agent acts on another task (wisp_task) | |
runtime.profiles |
Agent profiles | yes |
runtime.profile.set |
Add or change an agent profile | |
runtime.profile.remove |
Remove an agent profile | |
runtime.spec |
A task’s spec: what was asked, from which code, under which formula | yes |
runtime.snapshot |
The formula a task ran with | yes |
runtime.history |
Tasks by what made them | yes |
runtime.adopt |
Import a shared task, read-only | |
runtime.projectRun |
Run a project’s run scripts | |
runtime.discover |
Git repos on this computer that aren’t projects yet | yes |
runtime.folders |
Folders a typed path could go on to (the folder pickers’ suggestions) | yes |
runtime.exec |
Run a one-click command from a presentation in the task’s folder | |
runtime.appState |
Keep an app block’s state on its turn | |
runtime.usage |
Spend, turns, how many worked and questions asked over the last days | yes |
runtime.projectTest |
Set the command that runs a project’s tests | |
runtime.projectAdd |
Add a folder as a project (the same folder stays one project; a taken name gets -2) |
wisp.sandbox
Sandboxes on your wisp Grid: a task’s (/sandbox), a delegate’s, a crew job’s or member’s, a goal’s judges’; seeded with the project, deleted with their owner (ADR-0047)
| Command | What it does | Reads |
|---|---|---|
sandbox.launch |
Start a task in a sandbox of its own (/sandbox) | |
sandbox.place |
A seeded sandbox for a delegate, a crew job or member, or a goal’s judges | |
sandbox.seed |
Take a project in (inside a sandbox only) | |
sandbox.patch |
A project’s changes since it came in (inside a sandbox only) | yes |
sandbox.bring |
A delegate’s changes in its sandbox, into the lead’s folder here | |
sandbox.own |
Name a sandbox’s owner once it exists (a crew job’s task) | |
sandbox.drop |
Delete the sandboxes of a task, a crew member, or one by its machine | |
sandbox.info |
Your sandboxes, their owners, and what they start with | yes |
sandbox.claude.begin |
Sign in to Claude for every sandbox (claude setup-token) | |
sandbox.claude.code |
The code Claude’s sign-in page showed | |
sandbox.claude.state |
How the Claude sign-in for sandboxes is going | yes |
sandbox.logout |
Take a sandbox sign-in off the grid | |
sandbox.env |
An env var every sandbox gets (empty: taken out) |
wisp.settings
wisp.settings: list, read and change every plugin’s settings (the kernel’s registry), and /config
| Command | What it does | Reads |
|---|---|---|
settings.list |
Every setting | yes |
settings.get |
A setting’s value | yes |
settings.set |
Change a setting |
wisp.share
share a task as a signed .wisp-task bundle (spec, report or full), previewed with its redactions; open one someone sent; send any share to a destination (wisp Cloud) through share.destination@1
| Command | What it does | Reads |
|---|---|---|
share.preview |
What a share of this task would send | yes |
share.bundle |
Share a task (a signed bundle) | |
share.open |
Open a shared task | yes |
share.import |
Import a shared task, read-only | |
share.send |
Share a task, a setup or a doc to a destination (wisp Cloud) | |
share.destinations |
Where shares can go, and whether each is ready | yes |
share.create |
Share a task as a link (a passkey locks it) | |
share.stop |
Stop sharing a task’s link | |
share.peek |
What a pasted share link is, before it’s taken in | yes |
wisp.ship
Ship it: commit what a worktree task left, push its branch, open or update its PR; follow its checks and reviews, fix conflicts with a follow-up, squash-merge the reviewed head and fast-forward the user’s checkout.
| Command | What it does | Reads |
|---|---|---|
ship.fix_conflicts |
Fix a task’s PR conflicts: the task merges its base in | |
ship.check_log |
The end of a failing check’s log | yes |
ship.agent.pr |
Attach a PR to a task, or detach one, as its agent (wisp_pr) | |
ship.track |
Track a task’s repos for Ship it | |
ship.view |
What a task would ship | yes |
ship.ship |
Commit, push and open a pull request | |
ship.write |
Have a task’s agent write its pull request’s title and description | |
ship.refresh |
Ask GitHub about a task’s pull requests | |
ship.details |
A task’s pull requests in full | yes |
ship.merge |
Squash-merge a task’s pull request | |
ship.attach |
Attach a pull request to a task | |
ship.recheck |
Recheck what a task has to ship |
wisp.stuff
My Stuff: what you and your agents kept from tasks (pictures, videos, docs, code, files, links and apps), the apps’ launches and databases, the panes wisp ships, and uploads
| Command | What it does | Reads |
|---|---|---|
stuff.list |
List My Stuff | yes |
stuff.get |
Read one item | yes |
stuff.find |
Find in My Stuff (wisp_stuff) | yes |
stuff.describe |
One item in full, for an agent | yes |
stuff.grant |
What a pane may use now | yes |
stuff.save |
Save to My Stuff | |
stuff.update |
Edit an item | |
stuff.restore |
Back to the version before | |
stuff.remove |
Remove from My Stuff | |
stuff.allow |
Allow a pane what it asks for | |
stuff.setPublished |
Record where an app is published | |
stuff.bundle |
An app’s files packed for publishing (its secrets left out) | yes |
stuff.launch |
Launch an app | |
stuff.stop |
Stop an app | |
stuff.resetData |
Reset an app’s data | |
stuff.upload |
Read an attachment | yes |
stuff.receive |
Keep a file that came another way (an email’s attachment) as an upload | |
stuff.uploads |
Read attachments | yes |
stuff.removeUpload |
Remove an attachment | |
stuff.starters |
The panes wisp ships | yes |
stuff.addStarter |
Add a starter pane to My Stuff | |
stuff.reveal |
Show an item in its folder | |
stuff.targets |
Where an app can be published | yes |
stuff.publish |
Publish an app: a link anyone can open | |
stuff.unpublish |
Take an app’s public link down | |
stuff.agent.save |
Save to My Stuff, as a task’s agent (wisp_save) | |
stuff.agent.list |
My Stuff as a task’s agent reads it (wisp_stuff) | yes |
wisp.telemetry
wisp.telemetry: anonymous usage stats: the catalogue, opt-out, scrubbing, batching and the distinct id, delivered to every telemetry.sink (ADR-0021)
| Command | What it does | Reads |
|---|---|---|
telemetry.track |
Record a usage event | |
telemetry.set |
Usage stats on or off | |
telemetry.flush |
Send what is queued now | |
telemetry.feedback |
Send feedback to the wisp team |
wisp.termctx
wisp in a terminal knows what just happened there: the terminals’ own read commands (tmux, WezTerm, kitty, iTerm2, Terminal), the opt-in shell hook’s log, and terminal.failed as a trigger source (ADR-0023)
| Command | What it does | Reads |
|---|---|---|
termctx.sources |
How to read this terminal’s recent output | yes |
wisp.terminal
wisp.terminal: the plugin, wired to the kernel, proc and HTTP routes
| Command | What it does | Reads |
|---|---|---|
terminal.open |
Open a terminal | |
terminal.input |
Type into a terminal | |
terminal.close |
Hang a terminal up | |
terminal.shell.start |
Start the task’s shell | |
terminal.get |
A terminal | yes |
terminal.shell.info |
The task’s shell, for the panel | yes |
terminal.app.open |
Open a folder (and a command) in the terminal app Settings names | |
terminal.run.start |
Run the task’s app for its Preview | |
terminal.run.info |
The task’s app: running or not, its port, a command to start from | yes |
terminal.apps |
This computer’s terminal apps | yes |
wisp.threads
Long threads (ADR-0079): a task’s Notes kept outside the conversation (wisp_notes, the Thread tab, wisp notes), the note before each follow-up, the thread’s health, and where long command output goes
| Command | What it does | Reads |
|---|---|---|
threads.notes |
A task’s Notes: its goal, constraints, decisions, what failed, where it stands | yes |
threads.notesUpdate |
Rewrite one section of a task’s Notes | |
threads.revisions |
Every earlier version of a task’s Notes, with who wrote it | yes |
threads.health |
How worn a task’s thread is: context, compactions, turns, the same error again | yes |
threads.freshBrief |
The brief a fresh thread would start from (the Notes, the files changed, the last turns), to read and edit | yes |
threads.fresh |
Start a new conversation on the same task from a brief; the old one stays linked | |
threads.audits |
What each compaction kept of a task’s goal, constraints, decisions and what failed | yes |
wisp.update
wisp.update: a newer wisp, checked daily (npm dist-tags or GitHub Releases), and installed with npm or Homebrew
| Command | What it does | Reads |
|---|---|---|
update.check |
Check for a newer wisp now | |
update.install |
Install the newer wisp | |
update.view |
This wisp’s version, and the newest one | yes |
wisp.workflows
orchestration as code: DAGs of task specs with needs, if, matrix, outputs, retries, timeouts, budget and concurrency
| Command | What it does | Reads |
|---|---|---|
workflows.list |
Workflows | yes |
workflows.set |
Add or change a workflow | |
workflows.remove |
Remove a workflow | |
workflows.run |
Run a workflow |
wisp.worktrees
A checkout per session: made from the fresh base, prepared (.worktreeinclude, setup steps), brought back, removed only when nothing would be lost; Settings → Worktrees and the hourly sweep; Done’s folders; project trust, a before:run guard that holds a turn until the repo’s own programs are trusted.
| Command | What it does | Reads |
|---|---|---|
worktrees.source |
Open a file of a task’s folder (the file view) | yes |
worktrees.save |
Save a file of a task’s folder (refused while it runs, or if it changed) | |
worktrees.files |
A task folder’s (or a project’s) files, as git lists them | yes |
worktrees.warm |
Fetch a project’s remote now, while its task is typed (New task) | yes |
worktrees.grep |
Where a name is declared in a task’s folder (Go to definition) | yes |
worktrees.create |
Make a session’s worktree | |
worktrees.ensure |
Bring a removed worktree back from its branch | |
worktrees.remove |
Remove a worktree when nothing would be lost | |
worktrees.status |
A worktree’s changes, commits and pushes | yes |
worktrees.view |
Worktrees on disk | yes |
worktrees.viewLast |
Worktrees on disk, as last looked | yes |
worktrees.clean |
Remove worktrees by hand | |
worktrees.keep |
Keep a task’s worktree, or stop keeping it | |
worktrees.bringIn |
Bring in worktrees another tool left in a project, as tasks | |
worktrees.dismiss |
Stop offering a project’s other worktrees (Not now) | |
worktrees.sweep |
Tidy idle worktrees now | |
worktrees.done.list |
Done’s folders | yes |
worktrees.done.apply |
Remove or keep Done’s folders | |
worktrees.done.tidy |
Remove what’s clean and on its branch | |
worktrees.trust |
Trust a repo’s setup and start | |
worktrees.trust.pending |
What a repo would run before it is trusted | yes |