Goals

A goal is a dedicated agent loop against a repo path. It can read, write, run bash, and spawn subgoals. Use it for multi-step work. For one command, just run the command.

goal --background --path sites/sails --token-budget 100000 "Write today's blog post."
goal status GOAL_ID
goal log GOAL_ID

--path is the writable scope. Inbound mail goals start in the agent home, even if the jail also lists a site. If the job is to edit sites/sails, start the goal with that path.

Statuses include complete, impossible, token_budget, and time_budget.

How to: Give an agent a job.