Skip to main content
Start, follow, message, and manage coding agents, and reach their branches, ports, shells, and browser tabs. Every command also takes the global flags --json, -q, -w, and --url, described in CLI.

vespin agent start

Start an agent on a task

vespin agent continue

Continue an agent as a new one on its task, handed its brief and transcript, as the app’s Continue does; the agent is stopped, and the new one runs as you, on your own plan. —at forks it at a message instead, and it goes on

vespin agent list

List a task’s agents, or the workspace’s a page at a time, newest first

vespin agent view

Show an agent: where it stands, its branch, pull request, and checks

vespin agent logs

Print an agent’s transcript, or one of its workers’ with —worker, or one call of it whole with —call; —follow streams the turn under way (with —json, the whole transcript once it ends)

vespin agent send

Message an agent; it reads it at its next step, or starts a turn on it

vespin agent queue

List the messages queued behind an agent’s turn, and resume, hold, release, edit, delete, reorder, or steer them (your own agents only)

vespin agent queue resume

Resume an agent’s paused queue, which a Stop, a failed turn, or a refused hand-off pauses

vespin agent queue hold

Hold a queued message, as the app’s Edit does: the queue sends what stands ahead of it and stops there

vespin agent queue release

Let a held message go again, so the queue sends on past it

vespin agent queue edit

Write a queued message again in its place; it goes without the files it carried

vespin agent queue delete

Delete a queued message before it goes

vespin agent queue reorder

Put an agent’s queue in a new order

vespin agent queue steer

Send a queued message now, into the turn under way, and take it out of the queue; -F replaces its words and drops its files

vespin agent stop

Stop an agent’s turn; what it pushed stays

vespin agent update

Change an agent, one change a call: rename it, move it to another model, pin or unpin it, archive it or bring it back, or switch its MCP servers off

vespin agent rewind

Take an agent back to the moment before one of the lines sent to it, stopping it first; its checkout stays

vespin agent delete

Delete an agent for good, stopping it first; its branch and pull request on GitHub stay

vespin agent wake

Resume an agent’s stopped cloud sandbox and start its runner, so it answers at once

vespin agent forward

Serve an agent’s cloud ports on localhost until Ctrl-C or until its sandbox stops

vespin agent wait

Wait until an agent’s turn ends: exit 0 when it completed, 5 when it failed or was stopped, 6 on —timeout

vespin agent checkout

Fetch an agent’s branch from GitHub and check it out in this folder, as gh pr checkout does

vespin agent diff

Print the diff of an agent’s pull request, as GitHub holds it; —stat lists its files

vespin agent pr

Change an agent’s pull request on GitHub as you: mark it ready, turn it back into a draft, merge it, or turn auto-merge on or off

vespin agent ports

List the ports a server listens on in an agent’s cloud sandbox, each with what serves it, and the one shared by link

vespin agent share

Share a port of an agent’s running cloud sandbox by public link, show the link, or stop sharing

vespin agent tabs

List the tabs open in an agent’s cloud browser, and open, take over, or hand one back

vespin agent tabs open

Open a tab in an agent’s cloud browser, taken over for you until you hand it back

vespin agent tabs take

Take over a tab in an agent’s cloud browser so the agent leaves it alone, or renew your takeover; it lapses a minute after

vespin agent tabs hand-back

Hand a tab you drive in an agent’s cloud browser back to the agent

vespin agent shell

Open a shell in an agent’s sandbox, or attach to one of its Terminal tab’s shells; Ctrl-] detaches

vespin agent shells

List an agent’s shells: its Terminal tab’s, oldest first

vespin agent run

Run one of a cloud agent’s repository’s run actions in its sandbox, or stop it with —stop