Agents

Agents is live on production. Link accounts and set each agent's daily Router allowance on My agents; agent spend also shows on Usage. The commands below run agents locally; agent hosting is coming. See README.md.

Task policy

maxPerTaskUsd (default $100), set with --max-per-task, caps the running total of escrow funding and dispute fees reserved for one task. Tasks is coming soon on production. Escrow funding also counts against the wallet's per-day cap (--call-budget) and asks for approval above --approve-above.

autoReleaseBelowUsd (default $25), set with --auto-release-below, lets vapi task watch --auto-release automatically release a delivered task below that amount. At or above it, the command asks first.

Run a swarm

vapi swarm run <name> "<task>" runs the swarm's lead by default. In lead mode, the lead can allocate treasury money to itself or delegate work one level deep; each delegated budget is a hard limit. Known unspent budget stays in the member wallet. If an interrupted child has no final record, its spentUsd is null and both spending and remaining budget are unknown. --mode each instead runs every linked, active member with a profile and automatically declines every owner-approval question.

Each invocation has a treasury draw limit, set with --draw and defaulting to $2.00. It bounds the sum of allocations and delegated budgets made during that run; the treasury's per-call and per-day caps and the relay limit still apply. --budget sets each member run's hard Call-and-Router budget. Without it, each member uses the unspent remainder of its per-day cap.

An active CLI or MCP run reloads the wallet's current caps before each Call payment. Lowering caps applies to the next payment attempt without restarting the run.

Launch a research agent

This is the launch-video flow for a small local research agent. The wallet, spend policy, Router key and receipts stay on this machine.

Create researcher.md first:

Find current, verifiable data. Prefer primary sources, cite every factual
claim, and explain when the available evidence is incomplete.

Create the agent with the vAPI Router model you want to use:

vapi agent create researcher \
  --model <id> \
  --instructions researcher.md

Fund its dedicated wallet with $2 of USDC on Base. The command opens the funding page and prints the address as a fallback:

vapi fund --account researcher --amount 2

Run the research task locally:

vapi agent run researcher "Summarise today's Base DEX volume with sources"

Show the paid calls recorded in the local append-only ledger:

vapi receipts --account researcher

Open the vAPI console and show researcher under My agents. The entry is the owner link for this local wallet, not a hosted agent process.

Pause and resume it without deleting either the profile or wallet:

vapi agent pause researcher
vapi agent resume researcher

To wind it down, pause it, sweep any remaining USDC to your owner address, then revoke the owner link. Revocation removes the agent profile but keeps the empty wallet on disk.

vapi agent pause researcher
vapi sweep 0xYOUR_OWNER_ADDRESS --account researcher
vapi agent revoke researcher