Durable Agents

A durable agent is a named identity with its own workspace folder and default settings. Use them for recurring workstreams that should keep their context and files separate.

Create and use

budgetai agents create researcher --workspace ./research
budgetai agents list
budgetai agent --agent researcher -m "Collect this week's papers"

What an agent carries

• Its own workspace directory.
• Default provider, router, and permission settings.
• Its own memory scope and session history.

Subagents

An agent can spawn smaller subagent helpers, up to a limited depth, to divide a task. Subagent work rolls up into the parent's session and receipt.