Subagents

Copy Markdown View Source

Subagents are supervised jobs. LLM subagents create child Vibe sessions, so their work can be inspected or attached like any other session.

{:ok, job} = Vibe.Subagents.start("Review the storage search code")
Vibe.Subagents.status(job.id)
Vibe.Subagents.await(job.id)
Vibe.Subagents.result(job.id)
Vibe.Subagents.cancel(job.id)

Inspect jobs from the CLI:

vibe subagents jobs
vibe subagents status <job-id>
vibe subagents result <job-id>
vibe subagents cancel <job-id>

Attach to a child session from the shell:

vibe a <job.child_session_id>

Run one-off or parallel work:

Vibe.Subagents.ask("Summarize this repository")

Vibe.Subagents.run_many([
  %{task: "Inspect provider docs"},
  %{task: "Review the implementation plan"}
])

Pass role: :coder or another profile when you have configured the matching model/provider credentials.

Schedule background work:

{:ok, schedule} = Vibe.Subagents.schedule("Check telemetry errors", every: :timer.minutes(30))
Vibe.Subagents.scheduled()
Vibe.Subagents.unschedule(schedule.id)

Subagents should report findings to their parent session instead of writing global memory directly.