Vibe mode turns the top-level interactive session into a director for persistent background worker sessions instead of letting it edit or execute commands itself. The director's active tools are reduced to read, optional parent-owned todo, and five worker-control tools. Workers do the searching, editing, running, and building; the director verifies their claims by reading touched files. The parent owns the main todo list; workers normally omit todo, except when their own prewalk handoff requires it.
Toggle it with the /vibe slash command:
/vibe # enter vibe mode
/vibe fix the flaky test in packages/tui # enter and submit a first directive
/vibe # run again to exit
- Entering activates a parent-session worker scope, installs the vibe tools, reduces the active toolset to
read, optional parent-ownedtodo, and the vibe tools, and injects the director instructions. - An inline prompt (
/vibe <prompt>) enters the mode and submits that prompt as the first directive. - Exiting aborts any running director turn, suppresses queued-message replay during teardown, restores the prior toolset, cancels in-flight worker turns, and persists terminal lifecycle records for every worker in the scope.
- Vibe mode is mutually exclusive with both active and paused plan/goal modes; exit those modes first.
- Starting, deleting, forking, moving (including
/wt), or handing off the session is rejected while vibe mode is active. Reset-style/loopactions are also blocked. - The status line shows a
Vibeindicator while the mode is on; its token-rate display aggregates generating workers even while the director is idle.
/vibe is an interactive-TUI command. The mode and worker lifecycle events are persisted with the parent session. Resuming a session whose current mode is vibe rehydrates completed workers as idle/parked sessions with their child transcripts; a turn interrupted by process restart is not resumed automatically. Explicitly killed or mode-exit workers stay terminal.
Switching to a saved session suspends the source scope: running worker turns are cancelled and queued directives are cleared, but the persisted child conversations are not tombstoned. Returning to that parent can rehydrate them; this differs from deliberately exiting /vibe.
Every worker is a real, keep-alive task-executor subagent with the normal coding tool surface and its own persisted child transcript. Choose a tier when spawning:
| Tier | Bundled agent | Default role | Use for |
|---|---|---|---|
fast |
sonic |
@smol |
Mechanical execution, drafts, high-volume work |
good |
task |
@task |
Design, judgment calls, and reviewing fast output |
The tier always selects the bundled sonic or task definition, not a same-named discovered custom agent. Model resolution otherwise matches task-agent routing: task.agentModelOverrides.sonic / .task wins over the bundled agent model, and role aliases resolve through modelRoles, with the parent active/default model as fallback.
| Tool | Input and behavior |
|---|---|
vibe_spawn |
{ cli: "fast" | "good", prompt, name? }. Starts a blank worker with a complete, self-contained first brief. name is sanitized/capped at 48 characters; an id is generated when omitted. |
vibe_send |
{ session, message }. Steers a streaming turn at its next step; if a turn exists but cannot be steered, queues an automatic next turn; if idle/parked, starts the next turn immediately. |
vibe_wait |
{ sessions?, timeout? }. Waits for the first watched turn to settle (all in-flight workers when omitted), default 30 seconds. It acknowledges settled jobs so their result is not delivered twice. |
vibe_kill |
{ session }. Cancels an in-flight turn, clears queued messages, releases the worker, and retains any initialized transcript at history://<id>. |
vibe_list |
{}. Lists sessions in spawn order with tier, state, turn/queue counts, resolved model, and recent activity. |
Spawn and send return immediately. Each worker-turn result self-delivers into the director conversation through the async job manager; long response text is preview-capped there, with full output available at agent://<id>. Running fast and good workers on independent workstreams concurrently is the normal shape.
Several messages queued while one worker turn cannot be steered are joined into one automatic next-turn directive. vibe_list omits explicitly killed workers from its live wall and reports their ids separately; vibe_wait can still watch an explicitly named settled worker.
Worker ids are scoped to the owning agent and parent session; a worker from another scope is reported as unknown and cannot be controlled. Spawning requires the session async job manager. Spawn failures terminate the partial worker; failed lifecycle persistence can retain a dead record for mode-exit recovery. Turn failures self-deliver as failed job results, while a recoverable keep-alive worker returns to idle for another vibe_send. At turn settlement, a worker whose child session is no longer idle/parked in the same owner scope becomes dead. Sends reject stale or mismatched child-session identities rather than controlling another session.
- Split the request into independent workstreams — one persistent worker per workstream so each accumulates useful conversation context.
- Call
vibe_spawnwith a self-contained brief: files, constraints, and observable acceptance criteria. Workers start blank and never see the director's conversation. - Keep directing other workers while turns are in flight. Use
vibe_waitonly when blocked; a timed-out wait can be reissued. - Use
vibe_sendnaturally for corrections and next steps. A mid-turn send steers when possible; otherwise it becomes the worker's next turn automatically. - When a result arrives,
readtouched files and inspect full output when the preview is insufficient. Reconcile verified work through the optional parenttodo. - Route by difficulty: draft with
fast, escalate togoodwhen mechanical execution stalls or judgment is required. - Use
vibe_killfor a finished/stuck worker. Exiting the mode kills the entire remaining scope.
The director remains responsible for the final outcome: worker completion means the turn settled, not that its claims are correct.