Skip to content

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