docs/reference

CLI reference

Every command, flag, and corresponding API method.

Commands use vibeke <noun> <verb> [positionals] [--flag value]. Each command calls a control-API method. See the API reference.

Global flags are --session NAME, --machine NAME, --socket PATH, --timeout MS, --json, --pretty, --quiet, and --no-spawn.

Use --json to print JSON. Non-terminal output also uses JSON.

Main commands

  • vibeke or vibeke attach: connect the terminal client. Start the server if necessary.
  • vibeke ssh <host>: connect to a remote host.
  • vibeke update --check: check the latest published stable release.
  • vibeke update [--version VERSION]: download and verify a signed stable release, install it, and restart the selected local session. Other sessions and remote hosts keep their running versions. --json emits newline-delimited progress objects for online checks and updates.
  • vibeke update --rollback: restore the previous installed version. --from PATH installs a verified local artifact; --cached selects the newest cached artifact. Use --pretty for these offline operations. --force reinstalls; --allow-downgrade explicitly permits an older version.
  • vibeke login [--server URL] [--no-browser]: sign in to the account server of the hosted relay with a device code. The terminal prints a URL and a short code; open the URL on any device, sign in with GitHub, confirm the code. No browser is needed on this host.
  • vibeke logout and vibeke whoami: forget the stored credential, or print the signed-in account.
  • vibeke doctor: check the installation.
  • vibeke doctor --rebuild-index: rebuild the scrollback search index. Stop the server first.
  • vibeke doctor --list-backups and vibeke doctor --restore-backup NAME: list the pre-migration copies of the state database (the last three) and restore one. Stop the server first. Restoring rotates the event-log epoch and keeps the replaced database as state.db.pre-restore.
  • vibeke forget --pane p|--workspace w|--before t|--all [--yes] [--dry-run]: delete archived scrollback through scrollback.forget.
  • vibeke handoff incoming: list the incoming handoffs on this host (handoff.incoming.list).
  • vibeke handoff accept <id> [--repo PATH | --clone-to PATH] [--worktree PATH] [--branch NAME] [--no-resume] [--trust mise,direnv]: import an incoming handoff (handoff.accept). Without --repo or --clone-to it uses the clone and worktree path that handoff.incoming.get suggests.
  • vibeke handoff decline <id>: delete an incoming handoff without importing it.
  • vibeke handoff resume <id>: start the agent of an imported handoff again.
  • vibeke handoff prefs [--always-ask on|off]: show the remembered placements, or set whether handoffs from your own hosts always wait to be accepted.
  • vibeke handoff redeem <link> [--share-user]: pair this host with the host that made a peer or handoff invitation (like vibeke gateway peer add).
  • Inside a pane, vibeke handoff send|cancel|redeem ask for your approval through auth.approve and wait: approve, always or deny in Vibeke (prefix+shift+e) or with vibeke auth approval <request> approve|always|deny outside the pane. --no-wait prints the request id; Ctrl-C withdraws the request.
  • vibeke --skill: print the agent instructions.
  • vibeke --default-config: print the configuration template.
  • vibeke --version: print the version.

vibeke server

VerbPositionalsMethodDescription
status-server.statusserver pid, version, panes, clients
stop-server.stopStop the server. Holders remain active unless you use --kill-panes.
reload-config-server.reload_configreload config.toml

vibeke session

VerbPositionalsMethodDescription
snapshot-session.snapshotfull session state
list-session.listsessions in the runtime and state dirs
new<name>session.create<name>: start a server for a new session
stop<name>session.stop<name> [--kill-panes]
rename<name> <new_name>session.rename<old> <new> (stopped sessions only)

vibeke config

VerbPositionalsMethodDescription
get<key>config.get[key] [--repo dir | --cwd dir | --pane p] effective value and its source (default|user|repo|runtime|cli)
set<key> <value>config.set<key> <value> [--persist] (null resets; --persist writes config.toml, comments kept)
reload-config.reloadre-read config.toml

vibeke blob

VerbPositionalsMethodDescription
get<hash>blob.get<hash> [--range '{"offset":0,"length":N}'] [--out file]
stat<hash>blob.stat<hash>
put-blob.put--path file | --data-b64 …

vibeke workspace

VerbPositionalsMethodDescription
list-workspace.listworkspaces with agent summaries
get<workspace>workspace.get
create<cwd>workspace.create--cwd DIR [--name N] [--focus] [--layout NAME] [--group G]
rename<workspace> <name>workspace.rename
focus<workspace>workspace.focus
close<workspace>workspace.close
move<workspace>workspace.move[--group g | --group ''] [--delta n]

vibeke tab

VerbPositionalsMethodDescription
list-tab.list[--workspace w]
create-tab.create[--workspace w] [--cwd d] [--title t]
rename<tab> <title>tab.rename
renumber<workspace>tab.renumber[workspace] number the workspace's tabs 1..n in their current order
focus<tab>tab.focus
close<tab>tab.close
floats<tab>tab.floatsshow/hide floats [--visible true|false]

vibeke pane

VerbPositionalsMethodDescription
list-pane.list[--workspace w] [--tab t] [--has-agent]
get<pane>pane.get
current-pane.currentthe calling pane (needs VIBEKE_PANE_TOKEN)
split<pane>pane.split[--direction right|down|left|up] [--cwd d] [--command c] [--focus]
focus<pane>pane.focus[--direction left|right|up|down]
close<pane>pane.close
zoom<pane>pane.zoom
resize<pane>pane.resize--direction d [--percent n] [--mode edge|size]
toggle-split<pane>pane.toggle_split
swap<pane>pane.swap[--direction next|previous]
arrange<pane>pane.arrange[--layout next|columns|rows|main-left|main-top|tiled]
rename<pane> <title>pane.rename
send-text<pane> <text>pane.send_text[--paste auto|bracketed|raw]
send-keys<pane> <keys...>pane.send_keyskeys use the key grammar: enter ctrl+c alt+x y
run<pane> <command>pane.run[--wait] [--timeout-ms n]
read<pane>pane.read[--source visible|recent|recent_unwrapped|scrollback|archive] [--lines n] [--from N --to M (archive: absolute lines)]
wait-output<pane> <match>pane.wait_output[--regex r] [--timeout-ms n]
wait-idle<pane>pane.wait_idle[--quiet-ms n] [--timeout-ms n]
mark-unread<pane>pane.mark_unread
pin<pane>pane.pin
move<pane>pane.move[pane] --to-tab t | --to-workspace w | --new-tab-in w [--direction right] [--anchor p] [--focus]
scroll<pane> <to>pane.scroll[pane] bottom|top|line [--line n] | --delta n
screenshot<pane>pane.screenshot[pane] [--format ansi|text|html|svg|png|grid] [--source visible|recent] [--include-cursor] [--out file]
sync-input<action>pane.sync_inputstart|stop|status [--panes p1,p2 | --tab t] [--include-agents] [--group g] [--all] synchronized input (agents excluded unless --include-agents)
float<pane>pane.float[pane] float/move it | --tab t [--command c] [--cwd d] [--rect '{"x":15,"y":15,"w":70,"h":70}'] [--focus]
embed<pane>pane.embed[--target p] [--direction right|down|left|up]
revoke-token<pane>auth.revoke_token<pane> — Revoke the pane's API token. Its agent keeps running without API access until the pane restarts.

vibeke agent

VerbPositionalsMethodDescription
list-agent.list[--workspace w] [--harness h] [--all-machines]
get<target>agent.get
start<name>agent.start--harness claude|codex [--pane p] [--args a,b] [--yolo] [--isolate host|sandbox|container] [--confirm-host-yolo] [--network p]
spawn<name>agent.spawn--harness h [--split-of p] [--prompt text] [--focus]
prompt<target> <text>agent.prompt[--wait] [--timeout-ms n]
wait<target>agent.wait[--until idle,done,needs_approval,...] [--timeout-ms n]
interrupt<target>agent.interrupt
queued<target>agent.queuedmessages the harness holds until it can take them
send-now<target>agent.send_nowmake the harness deliver its queued messages now
send-keys<target> <keys...>agent.send_keys
read<target>agent.read[--source visible|recent|transcript] [--lines n]
transcript<target>agent.transcript[--limit n]
rename<target> <name>agent.rename
release<target>agent.release
resume<run>agent.resume[--pane p]
resumable-agent.resumableended runs that can be resumed
harnesses-agent.harnesses
commands<target>agent.commandsslash commands the agent understands (built-in catalog)
models<target>agent.modelsmodels the agent can switch to (where the harness offers a structured way)
set-model<target> <model>agent.set_model<target> <model> [--scope session|default]
turn-usage<run>agent.turn_usage<run> [--limit 200] — per-turn tokens and cost from the transcript
limits-agent.limitslatest rate-limit observation per harness
drift-agent.driftdisagreement/answer-failure counters per harness version

vibeke mention

VerbPositionalsMethodDescription
list-mention.list[--workspace w] named panes with label, harness and state (spec 19)
suggest<pane>mention.suggest<pane> a free name for the pane
set<pane> <name>mention.set<pane> [name] [--kind agent|terminal] [--no-delivery] (no name: the suggested one)
clear<pane>mention.clear<pane>

vibeke message

VerbPositionalsMethodDescription
send<body>message.send<body> --to name [--to name…] [--no-expects-reply] [--workspace w]
reply<message> <body>message.reply<message> <body> answer a message this pane received
complete<message>message.complete<message> done without an answer
get<id>message.get<message>
list-message.list[--pane p] [--direction in|out|all] [--open-only] [--limit n]
cancel<delivery>message.cancel<delivery>
retry<delivery>message.retry<delivery> deliver a held message again
take-message.takehand this pane's queued messages to its agent now (for integrations)

vibeke interaction

VerbPositionalsMethodDescription
list-interaction.list[--status open]
get<interaction>interaction.get
answer<interaction>interaction.answer--allow | --deny | --allow-always | --choice q=o | --text t
cancel<interaction>interaction.cancel

vibeke ask

VerbPositionalsMethodDescription
list-interaction.listalias of interaction list
answer<interaction>interaction.answeralias of interaction answer

vibeke notification

VerbPositionalsMethodDescription
list-notification.list
send<title> <body>notification.send
config-notification.configchannels, native backend, rules

vibeke events

VerbPositionalsMethodDescription
read-events.read[--after-seq n] [--types agent.*]
wait-events.wait--types t [--timeout-ms n]
VerbPositionalsMethodDescription
query<q>search.query[--pane p] [--workspace w] [--since 2h|epoch-ms] [--limit n] [--context n] [--regex] [--sources live,archive] (also: vibeke search <q>)

vibeke task

VerbPositionalsMethodDescription
new<title>task.create[--repo .] [--agent claude:name] [--base ref] [--root sibling] [--isolation worktree|jj_workspace|none|auto] [--yolo] [--isolate host|sandbox|container] [--confirm-host-yolo] [--network none|harness-apis|package-registries|dev|open] [--image ref] [--code clone|worktree] [--devcontainer] [--build]
list-task.list
compare<family>task.compare<family> [--pair k7.1 --pair k7.2]: side-by-side diff stats, checks and ranking of a best-of-N family (orchestrate.best_of_n)
pick<family> <child>task.pick<family> <child> [--merge] [--discard] [--force] [--target branch]: pick the winner of a best-of-N family
split-task.split[--run a12 | --pane p] [--paths a,b] [--title t] [--dry-run] [--resume]: move a running agent's uncommitted changes into a new task (orchestrate.split)
park<task>task.park<task> stop its agents gracefully, keep the worktree
resume<task>task.resume<task> restart the parked agents from their sessions
sync<task>task.sync<task> [--direction pull|push|both] [--force]: host-side fetch of a container task's commits (push = host commits into the box)
get<task>task.get<task> [--collisions: only the open shared-checkout collisions (05 §10)]
track-task.track[--pane @current|--run r] [--turn N] [--title t] [--criterion text]... [--stop-at draft_pr] — track the agent's work (no send, no spawn)
sources-task.sources[--pane p|--run r] — recent requests you can track
show<task>task.detailintent, bindings, baseline, messages
intent<task>task.intent.get[--revision N]
edit<task>task.intent.update[--title t] [--add-criterion text] [--stop-at x] [--expected-revision N] — record-only
bind<task>task.bind[--pane p|--run r] [--role implementation]
unbind<task>task.unbind[--binding b]
set<task>task.set[--priority N] [--effort quick|minutes|deep|unknown] [--effort-source heuristic|assistant:<request>]
snapshot<task>task.review.snapshot<task> — capture uncommitted work as an immutable, accept-capable subject (files, index and branches stay as they are)
snapshot-gc<task>task.review.snapshot.gc[task] | --repo path [--dry-run] [--include-unrecorded] — Delete unused snapshot refs. Preserve refs used by candidates, accepted reviews, review agents, or active checks. Print deleted refs.
effort<task>task.effort.estimate<task> — your effort, the deterministic heuristic (model estimate: assist generate effort_estimate --task)
reviewer<task>task.review.request_reviewer<task> [--harness claude] [--subject s] [--prompt text] — Show the review prompt. Do not start an agent.
reviewer-start<request> <prompt_digest>task.review.start_reviewer<request> <prompt-digest> [--pane p | --split-of p] — start the confirmed reviewer run (role review)
notes<task>task.review.notes<task> — reviewer findings (agent opinions, not evidence) and reviewer runs
note-classify<note> <classification>task.review.note.classify<note> blocking|not_blocking|dismissed [--reason r]
depend<task> <depends_on>task.dependency.add<task> <depends-on> [--kind blocks|related] — confirm a dependency link (cycles refused)
undepend<task> <depends_on>task.dependency.remove<task> <depends-on> [--kind k] | --edge e
deps<task>task.dependency.list[task] — confirmed links and how many open tasks each blocks
select<task>task.review.snapshot<task> --paths f [--paths g …] | --patch <unified diff> — capture only these files or hunks as a selected-patch subject (checks on it verify the selection alone)
human-review<task> <criterion> <verdict>task.review.human_review<task> <criterion> supported|failed|withdrawn [--note n] [--subject s] [--screenshots id] — your judgment of a human criterion on the shown revision
review-forget-task.review.forget--task t | --pane p | --workspace w | --before t | --all [--dry-run] — purge derived review content (messages, excerpts, prompts, notes, check logs)
link-task.link.status--run r | --pane p — why a run's identity is not verified, how to verify it, and verified runs to track instead
message<task> <text>task.message.prepare[--communicates-intent] — draft only
send<message>task.message.sendsend a prepared message (refuses with zero bytes when unsafe)
message-status<message>task.message.get
operation<idempotency_key>task.operation.getlook up a mutation receipt
finish<task>task.finish[--remove-worktree] [--force]
setup<task>task.setuprun the task's setup again (after policy trust); shows the setup pane
pr<task>task.pr[--refresh] pull request status through gh (cached 60 s; needs gh installed and logged in)
reconcile-task.reconcile[--repo r] compare tasks with the worktrees on disk (marks missing, reports orphans, deletes nothing)
setup-log<task>task.setup_log<task> [--max-bytes n] the tail of the task's setup log
archive<task>task.archive<task> [--force] stop agents (resume handles kept), delete the worktree, keep the branch
adopt<path>task.adopt[path] | --pane p [--title t] [--focus] record an existing worktree as a task; moves nothing
recreate<task>task.recreate<task> recreate a missing task's worktree at its path from its branch
forget<task>task.forget<task> [--force] drop a missing (or finished) task's record; touches no files
ports<task>task.ports<task> [--re-lease] the leased port block and its env; --re-lease moves to another block

vibeke family

VerbPositionalsMethodDescription
list-family.list
get<family>family.get
check<family>family.check<family> [--child k7.1]: run the family's check command in each child

vibeke claim

VerbPositionalsMethodDescription
add<glob>task.claim<glob> --task k7 | --run a12 [--note text]: claim files for a task (advisory; orchestrate.merge); a run with no task gets a run claim for the collision tracker
list-task.claim.list[--task k7]
remove<claim>task.claim.remove

vibeke merge

VerbPositionalsMethodDescription
predict-merge.predict[--repo path] [--tasks k1,k2]: predicted conflicts between live worktrees
add<task>merge.queue.add<task> [--target main] [--priority n] [--run] [--allow-dirty]: queue a task branch
list-merge.queue.list[--all]
cancel<entry>merge.queue.cancel
requeue<entry>merge.queue.requeue
run-merge.queue.run[--entry id] [--count n | --all]: merge the next queue entries

vibeke goal

VerbPositionalsMethodDescription
create<title>goal.create<title> [--text t | --text-file f] [--repo .] [--no-plan]
list-goal.list
get<goal>goal.get
plan<goal>goal.plan<goal> [--backend heuristic|agent|external]
plan-submit<goal>goal.plan_submit<goal> --file plan.json | --plan '<json>'
approve<goal>goal.approve<goal> [--no-start]: approve the plan and start its ready steps
start<goal>goal.start
step-done<goal> <step>goal.step_done<goal> <step> [--no-ok] [--error text]
cancel<goal>goal.cancel<goal> [--stop-tasks]
briefing-goal.briefing[--since 12h|epoch-ms]: what happened while you were away

vibeke quota

VerbPositionalsMethodDescription
status-quota.status
tick-quota.tick[--dry-run]
route-quota.route[--harnesses claude,codex]
resume<key>quota.resume<task-or-run> resume work the scheduler paused

vibeke vm

VerbPositionalsMethodDescription
status-vm.status
list-vm.list
create-vm.create[--name n] [--task t] [--checkout dir] [--no-template]
start<vm>vm.start
stop<vm>vm.stop
suspend<vm>vm.suspend
resume<vm>vm.resume
destroy<vm>vm.destroy
snapshot<vm>vm.snapshot<vm> [--label l]
snapshot-delete<snapshot>vm.snapshot.delete<vm/label> [--force]
fork<snapshot>vm.fork<vm/label> [--count n] [--prefix p]
transport<vm>vm.transport
template-list-vm.template.list
template-build-vm.template.build
template-delete<key>vm.template.delete

vibeke sandbox

VerbPositionalsMethodDescription
status-sandbox.statuswhich isolation levels and providers work here (13 §11)
list-sandbox.listlive sandbox contexts, proxies, approvals
allow<task> <host>sandbox.allowallow a domain for a sandboxed task's egress proxy
start<task>sandbox.startcreate or start a container task's box
stop<task>sandbox.stopStop the task container. Its pane processes end.
rm<task>sandbox.remove<task> [--force]: sync, then remove a container box (kept when unsynced unless --force)
disallow<host>sandbox.disallow<host> [--task t | --global]: drop an egress approval (global without --task)
logs<task>sandbox.logs<task> [--tail n]: box output, setup log and recent sandbox events
prune-sandbox.prune[--dry-run]: remove boxes and box dirs no task owns any more
recover<task>sandbox.recover<task>: fresh box after the old one was lost; resumes the lost runs
relaunch<run>sandbox.relaunch<run> [--isolate sandbox|container] [--network p]: restart a host yolo run from its session inside a box
push<task>sandbox.push<task> [--remote origin]: push the task branch from the host (boundary action)
copy-out<task> <path>sandbox.copy_out<task> <path>: copy one file out of the box into the host outbox
request<kind>sandbox.requestpush|copy_out [--path p] [--remote r]: from inside a box, ask the host for a boundary action
setup-token-sandbox.setup_tokenstore claude setup-token output read from stdin (projected as CLAUDE_CODE_OAUTH_TOKEN)

vibeke policy

VerbPositionalsMethodDescription
trust<path>policy.trustTrust repository automation at its current digest. Print the setup script.
list-policy.list[--scope dir] — merged rules: config.toml, added with policy add, trusted repositories
add-policy.add--effect allow|deny|ask [--tool T] [--command-regex RE] [--path-glob G] [--url-glob G] [--scope dir] [--note text]
remove<rule_id>policy.remove<rule> — only rules added with policy add (p-…)
test-policy.test--tool T [--command C] [--path P] [--url U] [--scope dir] — what an approval would get (dry run)

vibeke collision

VerbPositionalsMethodDescription
claim<glob>collision.claim<glob> [--run r|--task t] [--root dir] [--note text]: say which part of the checkout this run works in (advisory; another run writing there raises a high collision)
claims-collision.claims[--task t|--run r|--root dir]: run claims and the task claims that bind each checkout
unclaim<claim>collision.claim_release<claim> | --run r [--glob g]: release a run claim
list-collision.list[--task t] [--run r] [--status open|cleared|ignored|all]: shared-checkout collisions (advisory)
get<collision>collision.get<collision>: paths, runs, timeline and how each run can be told
status-collision.statustracker config, the checkouts followed, claims
ignore<collision> <path>collision.ignore<collision> <path> [--for-secs n]: stop tracking a path (or --root dir <path> without a collision)
ignores-collision.ignores[--root dir]
unignore<ignore>collision.unignore<ignore id>
dismiss<collision>collision.dismiss<collision> [--dismissed false]: hide the warning until it gets worse
pause<collision> <run>collision.pause<collision> <run>: the adapter's interrupt for one run
tell<collision>collision.tell<collision> [--runs r]... [--text t]: native steer only (never typed into a TUI)
fresh<collision>collision.start_task<collision> [--run r] [--title t] [--harness h] [--prompt text] [--dry-run]: a new task from the shared checkout's HEAD with a hand-off prompt; nothing is moved

vibeke worktree

VerbPositionalsMethodDescription
list-worktree.list[--cwd d]
remove<path>worktree.remove[--force] [--dry-run] (async)
repo-root<cwd>worktree.repo_root

vibeke layout

VerbPositionalsMethodDescription
export<tab>layout.export[tab] | --workspace w [--format toml|json]
apply<name>layout.apply<name from [layouts.*] | file.toml|.json> | --file f | --doc text [--workspace w | --cwd d --ws-name n] [--focus]
list-layout.listnamed layouts in config
get<name>layout.get

vibeke group

VerbPositionalsMethodDescription
list-group.listworkspace groups
create<name>group.create[--parent g]
rename<group> <name>group.rename
move<group>group.move[--parent g] [--index n | --delta n]
delete<group>group.deletemembers move to the parent
collapse<group>group.collapse[--collapsed true|false]
add<group> <workspace>group.add[--index n]
remove<workspace>group.remove

vibeke theme

VerbPositionalsMethodDescription
get-theme.geteffective light/dark theme
set-mode<mode>theme.set_modeauto|light|dark (runtime, not persisted)

vibeke client

VerbPositionalsMethodDescription
appearance-client.appearance--dark true|false (host terminal appearance)
focus<pane>client.focus[--url vibeke://focus?…] [--no-raise] (also: vibeke focus <pane|url>)
list-client.list

vibeke status

VerbPositionalsMethodDescription
segments-status.segments[--pane p] [--client c] status-bar segment data

vibeke machine

VerbPositionalsMethodDescription
list-machine.listsaved remote machines
add<label> <address>machine.adduser@host
remove<machine>machine.remove
connect<machine>machine.connect
disconnect<machine>machine.disconnect
status<machine>machine.status
show<machine>machine.show[--offline] saved settings, remote version, link state, local artifact trust
upgrade<machine>machine.upgrade[--from artifact [--version v]] [--stage-only] [--force] verified install/upgrade

vibeke preview

VerbPositionalsMethodDescription
declare<port>preview.declare--port N [--path /p] [--label l] [--pane p] [--task k] [--tls-origin | --no-tls-origin] (proxy mode: serve this preview over https)
list-preview.list[--machine m] [--task k] [--pane p] [--all] (suggestions with --all)
get<preview>preview.get
open<preview>preview.open<v4|devbox/v4|url> [--split right|down|tab|float | --window | --proxy [--no-open] [--tls-origin | --no-tls-origin]] [--pane p] [--machine m] [--viewport WxH | --device iphone-15]
url<preview>preview.url
mirror<preview>preview.mirror<devbox/v4> Bind the remote port to this host's loopback address. This explicit connection is unauthenticated.
unmirror<preview>preview.unmirror<devbox/v4 | port> stop a mirror
promote<preview>preview.promoteaccept a suggestion
forget<preview>preview.forget
show<preview>screenshot.list<v4|devbox/v4> [--no-image] the latest screenshot of a preview, inline (kitty graphics, iTerm2) or path + metadata
trust-ca-preview.trust_ca[--install] [--path] print the CA file, fingerprint and per-OS instructions to trust the tls_origin CA (local; never installs without --install and a typed confirmation)
profile<action> <profile>preview.profilelist | reset <profile>
status-preview.statusSOCKS port, managed browsers, links

vibeke browser

VerbPositionalsMethodDescription
open<target>browser.open<preview|url> [--viewport 390x844] [--device iphone-15|pixel-8|ipad|desktop-1280|desktop-1440|desktop-1920] [--dark] — headless session on this machine
navigate<session> <url>browser.navigate<session> <url|/path> [--wait load|domcontentloaded|none]
click<session> <selector>browser.click<session> <css|text=…> | --x N --y N [--timeout-ms n]
type<session> <selector> <text>browser.type<session> [selector] <text> [--submit] [--clear]
press<session> <key>browser.press<session> <key> (enter, tab, ctrl+a, ArrowDown)
wait<session> <for>browser.wait<session> load|networkidle|selector:<css>|ms:<n>
eval<session> <expression>browser.eval<session> <js> (from a pane: needs preview.browser_script)
screenshot<session>browser.screenshot<session|preview|url> [--full-page] [--selector css] [--out f.png] — A preview or URL uses a new context for one capture. Options: [--device d] [--viewport WxH].
snapshot<session>browser.snapshot<session> [--format a11y|text|html] [--selector css]
dom<session>browser.domalias of snapshot
console<session>browser.console<session> [--level error|warn|all] [--since 5m] | --pane <browser pane> [--follow] [--console|--network] [--errors] (follow keys: c n e a q)
console-split<pane>browser.pane.console<browser pane> toggle the console/network split under it (prefix+alt+c)
annotate<pane>browser.annotate<browser pane> [--on|--no-on] — annotate mode: click an element or shift-drag a region to add a note (prefix+alt+n)
annotations<pane>browser.annotations<browser pane> | --session s | --preview v | --draft d — the page notes waiting to be sent
annotations-split<pane>browser.pane.annotations<browser pane> [--open|--no-open] — toggle the notes panel under it
feedback-browser.feedback[--pane p] [--wait-ms N | --wait SECONDS] — take the user's page notes addressed to this pane (waits for them)
viewport<pane> <viewport>browser.pane.update<browser pane> <WxH | fit> | --device iphone-15|pixel-8|ipad|desktop-1280|desktop-1440|desktop-1920 — pin the page size (letterboxed)
network<session>browser.network<session> [--failed] [--since 5m]
close<session>browser.close
list-browser.listsessions you can see + browser status
status-browser.status
install-browser.install[--yes] [--full | --headless-shell] [--sha256 hex] [--url u] — asks before downloading Chrome for Testing (default: the full browser where a display is available, else the headless shell)
take-over<session>browser.take_overagent calls fail with human_control until release
release<session>browser.release
watch<session>browser.watch<session> [--pane p] [--split right|down|tab] — View an agent session in a read-only browser pane. Press prefix+t to take control.
pane-status-browser.pane.statusbrowser panes rendered here: browsers, targets, fps
panes-browser.pane.listbrowser panes in this server's layout
pane<url>browser.pane.create<url> [--pane p] [--split right|down|tab] [--viewport WxH | --device iphone-15]
command<pane> <cmd>browser.command<pane> back|forward|reload|stop|navigate --url u|screenshot|window|pane
diff<a> <b>browser.diff<shotA> <shotB> [--threshold 0.1] [--force] [--out diff.png] — changed ratio, regions, diff image

vibeke screenshot

VerbPositionalsMethodDescription
list-screenshot.list[--task t] [--preview v4] [--run r] [--pane p] [--workspace w] [--environment agent] [--since 1h] [--limit 50]
get<id>screenshot.get<sN|id> [--out f.png] — environment, code state, running build, binding, path
open<id>screenshot.open<sN|id> — copy to a local temp file and open it
diff<a> <b>browser.diff<shotA> <shotB> [--threshold 0.1] [--force] [--out diff.png]
add<files...>screenshot.add<file>... [--caption text] [--pane p] — attach PNG or JPEG files so the user can see them (terminal, desktop app, phone)
delete<id>screenshot.delete<sN|id> [--force] From a pane, only images that pane attached. Use --force for screenshots in an accepted review.
code-state<path>screenshot.code_state[dir] — Print local code state as JSON. Serve the result at /__vibeke_build.

vibeke desk

VerbPositionalsMethodDescription
search<text...>desk.search<words> [--repo dir] [--harness h] [--since 7d|YYYY-MM-DD] [--until …] [--limit n] [--sort recent]
sessions-desk.sessions[--repo dir] [--harness h] — live / resumable / neither
open<session>desk.open<session> [--turn n] [--focus] — Change focus only with --focus. Otherwise, show resume options.
resume<session>desk.resume<session> [--pane p] = Resume native session | --mode new_agent [--start --harness h] = Start new agent with context (an unsent draft)
context<session>desk.context<session> [--turns 3-5] [--objective text] — editable context package
forget<session>desk.forget<session> | --repo dir | --workspace w | --before date — purge from the conversation index
status-desk.statusindexed sources, selection, exclusions, retention
index-desk.indexrun an indexing pass now

vibeke draft

VerbPositionalsMethodDescription
new<text>draft.create<text|-> [--workspace w | --task t] [--file path]… [--screenshot path]… [--title t]
list-draft.list[--workspace w | --task t] [--all]
show<draft>draft.get
edit<draft>draft.update<draft> [--text t|-] [--title t] [--file path] [--remove-attachment i] [--expected-rev n]
check<draft>draft.check<draft> --run r — send_path prompt_input | open_pane_only and why
send<draft>draft.send<draft> --run r [--include-notes] [--keep] [--retry-despite-unknown] (zero bytes when unsafe)
reconcile<draft>draft.reconcileinspect an uncertain send before retrying
combine<ids...>draft.combine<draft> <draft>… [--title t] [--delete-sources]
reorder<order...>draft.reorder<draft>… in their new order
rm<draft>draft.delete

vibeke notes

VerbPositionalsMethodDescription
get-notes.get[--workspace w] — never sent unless included
set<text>notes.set<text|-> [--workspace w]

vibeke assist

VerbPositionalsMethodDescription
status-assistant.statusenabled/configured state, coordinator, profile, budgets, consents (no secrets)
providers-assistant.providersconfigured connections and profiles (no secrets)
consent<workspace>assistant.consent[workspace] [--connection c] [--classes selected_text,structured_state,review_package,screen] [--operations op,...] [--auto-send op,...]
revoke<workspace>assistant.revoke[workspace] [--connection c] — also cancels unfinished requests there
generate<operation>assistant.generatesuggest_task_details|review_summary|pane_title|briefing|handoff|effort_estimate|navigate|decision_card|task_title|reply_suggestions [--run r] [--turns 3,4] [--pane p] [--task t] [--workspace w] [--query text] [--interaction i] [--stream] [--priority background] [--include-screen] — Show the exact payload. Do not send it.
confirm<request> <preview_digest>assistant.confirm<request> <preview-digest> — send the previewed payload
show<request>assistant.get<request> — lifecycle, usage, cost, sources and the generated draft
list-assistant.list[--workspace w] [--state done] [--limit 50]
cancel<request>assistant.cancel<request>
purge<request>assistant.purge<request> | --workspace w | --all — forget generated outputs
models<connection>assistant.models[connection] [--profile p] [--refresh] — live|cached|bundled model list with capability records; --refresh asks the provider
test-assistant.test[--profile p] [--probe streaming,json_schema] — an explicit small generation, counted as usage; probes record what works
background<action>assistant.background[status|tick] — the opt-in background sweeper (summaries, stall notices)

vibeke assistant

VerbPositionalsMethodDescription
status-assistant.statusenabled/configured state, coordinator, profile, budgets, consents (no secrets)
providers-assistant.providersconfigured connections and verified adapters (no secrets)
models<connection>assistant.models--connection <id> [--refresh] — model list with live|cached|bundled provenance and capability records
test-assistant.test[--profile p] [--probe streaming,json_schema] — explicit small generation, counted as usage
brief<workspace>assistant.generate[workspace] — preview a briefing request for a workspace (then assistant confirm)
generate<operation>assistant.generate<operation> [flags] — show the exact payload; nothing is sent
confirm<request> <preview_digest>assistant.confirm<request> <preview-digest> — send the previewed payload
get<request>assistant.get<request> — lifecycle, usage, cost, sources, staleness and the generated draft
list-assistant.list[--workspace w] [--state done] [--limit 50]
cancel<request>assistant.cancel<request>
consent<workspace>assistant.consent[workspace] [--remote-workspace machine:/path] [--connection c] [--classes ...] [--operations ...] [--auto-send ...]
revoke<workspace>assistant.revoke[workspace] [--remote-workspace machine:/path] [--connection c]
purge<request>assistant.purge<request> | --workspace w | --all — forget generated outputs and cached results
background<action>assistant.background[status|tick]

vibeke api

VerbPositionalsMethodDescription
methods-api.methodslist API methods

vibeke auth

VerbPositionalsMethodDescription
revoke-token<pane>auth.revoke_token<pane> — same as pane revoke-token
elevate<reason>auth.elevate[reason] [--timeout-ms 120000] — From a pane: ask the user for 10 minutes of full API access. Prints the token for VIBEKE_ELEVATED_TOKEN.
decide<request> <decision>auth.elevate.decide<request> approve|deny — Decide an elevation request. Run outside any pane.
approval<request> <decision>auth.approve.decide<request> approve|always|deny — Decide a pane's request to run one call (vibeke handoff send|cancel|redeem in a pane). Approve runs it once; always also allows the same call for that pane and peer until the pane restarts. Run outside any pane.
list-auth.listpending elevation requests, live elevations, revoked panes, open approval requests, standing grants

vibeke audit

VerbPositionalsMethodDescription
tail-audit.tail[--limit 50] [--types policy.,auth.]
search<query>audit.search<text> [--types t] [--since-ms ms] [--limit 200]
verify-audit.verifyrecompute the audit log's hash chain (also part of vibeke doctor)

vibeke handoff

VerbPositionalsMethodDescription
send<peer>handoff.send<peer> [--pane p] [--interrupt] — hand this pane's work (default: the pane you run it in) to another host; the gateway exports and delivers it. Inside a pane it asks for your approval in Vibeke first ([--no-wait] [--reason text]).
jobs-handoff.jobsoutgoing handoffs: state, progress, the destination's answer
cancel<id>handoff.cancel<job> — stop an outgoing handoff; the destination drops what it received (inside a pane: only its own, after your approval)
peers-handoff.peershosts this one can hand work to (add one with vibeke gateway peer add <link>)

vibeke cloud

VerbPositionalsMethodDescription
providers-cloud.providersproviders: sign-in state and account [--verify]
logout<provider>cloud.auth.clear<provider> — forget the stored credential (running sandboxes keep running)
ls-cloud.box.listsandboxes of every signed-in provider [--provider P] [--ownership attached|idle|orphaned|foreign|missing] [--refresh]
rm<box>cloud.box.destroy<provider/id> [--force] — destroy a sandbox; unsynced work needs --force (put --force after the box)
suspend<box>cloud.box.suspend<provider/id> — suspend a sandbox (providers that sleep by themselves refuse)
resume<box>cloud.box.resume<provider/id> — wake a suspended sandbox
adopt<box>cloud.box.adopt<provider/id> — take over an orphaned or foreign sandbox: creates a task and reopens its sessions
forget<box>cloud.box.forget<provider/id> — drop the record of a sandbox the provider no longer lists
checkpoint<box>cloud.box.checkpoint<provider/id> [--note TEXT] — save a checkpoint (providers with checkpoints)
prune-cloud.prune[--dry-run] [--force] [--provider P] — destroy orphaned and idle sandboxes without unsynced work
jobs-cloud.jobsmoves to and from sandboxes: state, progress, errors
cancel<id>cloud.cancel<job> — stop a move that is still running
move-cloud.move(--pane P | --run R | --box B) --to cloud|local|<peer> [--provider X] [--into BOX] [--interrupt] [--source-after keep|suspend|destroy] — start a move (cloud send and cloud bring-back follow it)

vibeke security

VerbPositionalsMethodDescription
status-security.encryption.statusstate encryption (security.encrypt_state): key, keychain, sealed/plain file counts
migrate<to>security.encryption.migratesealed|plain [--dry-run] — rewrite existing scrollback segments and blobs