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
vibekeorvibeke 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.--jsonemits newline-delimited progress objects for online checks and updates.vibeke update --rollback: restore the previous installed version.--from PATHinstalls a verified local artifact;--cachedselects the newest cached artifact. Use--prettyfor these offline operations.--forcereinstalls;--allow-downgradeexplicitly 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 logoutandvibeke 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-backupsandvibeke 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 asstate.db.pre-restore.vibeke forget --pane p|--workspace w|--before t|--all [--yes] [--dry-run]: delete archived scrollback throughscrollback.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--repoor--clone-toit uses the clone and worktree path thathandoff.incoming.getsuggests.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 (likevibeke gateway peer add).- Inside a pane,
vibeke handoff send|cancel|redeemask for your approval throughauth.approveand wait: approve, always or deny in Vibeke (prefix+shift+e) or withvibeke auth approval <request> approve|always|denyoutside the pane.--no-waitprints 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
| Verb | Positionals | Method | Description |
|---|---|---|---|
status | - | server.status | server pid, version, panes, clients |
stop | - | server.stop | Stop the server. Holders remain active unless you use --kill-panes. |
reload-config | - | server.reload_config | reload config.toml |
vibeke session
| Verb | Positionals | Method | Description |
|---|---|---|---|
snapshot | - | session.snapshot | full session state |
list | - | session.list | sessions 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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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.reload | re-read config.toml |
vibeke blob
| Verb | Positionals | Method | Description |
|---|---|---|---|
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
| Verb | Positionals | Method | Description |
|---|---|---|---|
list | - | workspace.list | workspaces 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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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.floats | show/hide floats [--visible true|false] |
vibeke pane
| Verb | Positionals | Method | Description |
|---|---|---|---|
list | - | pane.list | [--workspace w] [--tab t] [--has-agent] |
get | <pane> | pane.get | |
current | - | pane.current | the 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_keys | keys 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_input | start|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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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.queued | messages the harness holds until it can take them |
send-now | <target> | agent.send_now | make 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.resumable | ended runs that can be resumed |
harnesses | - | agent.harnesses | |
commands | <target> | agent.commands | slash commands the agent understands (built-in catalog) |
models | <target> | agent.models | models 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.limits | latest rate-limit observation per harness |
drift | - | agent.drift | disagreement/answer-failure counters per harness version |
vibeke mention
| Verb | Positionals | Method | Description |
|---|---|---|---|
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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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.take | hand this pane's queued messages to its agent now (for integrations) |
vibeke interaction
| Verb | Positionals | Method | Description |
|---|---|---|---|
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
| Verb | Positionals | Method | Description |
|---|---|---|---|
list | - | interaction.list | alias of interaction list |
answer | <interaction> | interaction.answer | alias of interaction answer |
vibeke notification
| Verb | Positionals | Method | Description |
|---|---|---|---|
list | - | notification.list | |
send | <title> <body> | notification.send | |
config | - | notification.config | channels, native backend, rules |
vibeke events
| Verb | Positionals | Method | Description |
|---|---|---|---|
read | - | events.read | [--after-seq n] [--types agent.*] |
wait | - | events.wait | --types t [--timeout-ms n] |
vibeke search
| Verb | Positionals | Method | Description |
|---|---|---|---|
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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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.detail | intent, 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.send | send a prepared message (refuses with zero bytes when unsafe) |
message-status | <message> | task.message.get | |
operation | <idempotency_key> | task.operation.get | look up a mutation receipt |
finish | <task> | task.finish | [--remove-worktree] [--force] |
setup | <task> | task.setup | run 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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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
| Verb | Positionals | Method | Description |
|---|---|---|---|
status | - | sandbox.status | which isolation levels and providers work here (13 §11) |
list | - | sandbox.list | live sandbox contexts, proxies, approvals |
allow | <task> <host> | sandbox.allow | allow a domain for a sandboxed task's egress proxy |
start | <task> | sandbox.start | create or start a container task's box |
stop | <task> | sandbox.stop | Stop 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.request | push|copy_out [--path p] [--remote r]: from inside a box, ask the host for a boundary action |
setup-token | - | sandbox.setup_token | store claude setup-token output read from stdin (projected as CLAUDE_CODE_OAUTH_TOKEN) |
vibeke policy
| Verb | Positionals | Method | Description |
|---|---|---|---|
trust | <path> | policy.trust | Trust 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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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.status | tracker 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
| Verb | Positionals | Method | Description |
|---|---|---|---|
list | - | worktree.list | [--cwd d] |
remove | <path> | worktree.remove | [--force] [--dry-run] (async) |
repo-root | <cwd> | worktree.repo_root |
vibeke layout
| Verb | Positionals | Method | Description |
|---|---|---|---|
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.list | named layouts in config |
get | <name> | layout.get |
vibeke group
| Verb | Positionals | Method | Description |
|---|---|---|---|
list | - | group.list | workspace 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.delete | members move to the parent |
collapse | <group> | group.collapse | [--collapsed true|false] |
add | <group> <workspace> | group.add | [--index n] |
remove | <workspace> | group.remove |
vibeke theme
| Verb | Positionals | Method | Description |
|---|---|---|---|
get | - | theme.get | effective light/dark theme |
set-mode | <mode> | theme.set_mode | auto|light|dark (runtime, not persisted) |
vibeke client
| Verb | Positionals | Method | Description |
|---|---|---|---|
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
| Verb | Positionals | Method | Description |
|---|---|---|---|
segments | - | status.segments | [--pane p] [--client c] status-bar segment data |
vibeke machine
| Verb | Positionals | Method | Description |
|---|---|---|---|
list | - | machine.list | saved remote machines |
add | <label> <address> | machine.add | user@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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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.promote | accept 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.profile | list | reset <profile> |
status | - | preview.status | SOCKS port, managed browsers, links |
vibeke browser
| Verb | Positionals | Method | Description |
|---|---|---|---|
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.dom | alias 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.list | sessions 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_over | agent 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.status | browser panes rendered here: browsers, targets, fps |
panes | - | browser.pane.list | browser 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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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
| Verb | Positionals | Method | Description |
|---|---|---|---|
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.status | indexed sources, selection, exclusions, retention |
index | - | desk.index | run an indexing pass now |
vibeke draft
| Verb | Positionals | Method | Description |
|---|---|---|---|
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.reconcile | inspect 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
| Verb | Positionals | Method | Description |
|---|---|---|---|
get | - | notes.get | [--workspace w] — never sent unless included |
set | <text> | notes.set | <text|-> [--workspace w] |
vibeke assist
| Verb | Positionals | Method | Description |
|---|---|---|---|
status | - | assistant.status | enabled/configured state, coordinator, profile, budgets, consents (no secrets) |
providers | - | assistant.providers | configured 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.generate | suggest_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
| Verb | Positionals | Method | Description |
|---|---|---|---|
status | - | assistant.status | enabled/configured state, coordinator, profile, budgets, consents (no secrets) |
providers | - | assistant.providers | configured 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
| Verb | Positionals | Method | Description |
|---|---|---|---|
methods | - | api.methods | list API methods |
vibeke auth
| Verb | Positionals | Method | Description |
|---|---|---|---|
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.list | pending elevation requests, live elevations, revoked panes, open approval requests, standing grants |
vibeke audit
| Verb | Positionals | Method | Description |
|---|---|---|---|
tail | - | audit.tail | [--limit 50] [--types policy.,auth.] |
search | <query> | audit.search | <text> [--types t] [--since-ms ms] [--limit 200] |
verify | - | audit.verify | recompute the audit log's hash chain (also part of vibeke doctor) |
vibeke handoff
| Verb | Positionals | Method | Description |
|---|---|---|---|
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.jobs | outgoing 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.peers | hosts this one can hand work to (add one with vibeke gateway peer add <link>) |
vibeke cloud
| Verb | Positionals | Method | Description |
|---|---|---|---|
providers | - | cloud.providers | providers: sign-in state and account [--verify] |
logout | <provider> | cloud.auth.clear | <provider> — forget the stored credential (running sandboxes keep running) |
ls | - | cloud.box.list | sandboxes 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.jobs | moves 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
| Verb | Positionals | Method | Description |
|---|---|---|---|
status | - | security.encryption.status | state encryption (security.encrypt_state): key, keychain, sealed/plain file counts |
migrate | <to> | security.encryption.migrate | sealed|plain [--dry-run] — rewrite existing scrollback segments and blobs |