DocsWorking with Alran
Goal Mode
Set a finish line. Alran keeps going, turn after turn, until it is met.
How do I set a goal?
/goal Every listing can be booked online, with tests.A normal message ends when Alran answers. A goal doesn't: Alran keeps working across turns, checks its progress against the objective and stops when the goal is complete, or when it is blocked and needs you. A banner shows the goal and its status the whole time.
✓ Goal complete · 1h20min0s · 1.1M tokens · 3 turnsGive it a budget
/goal Migrate the API to v2 budget=500KThe budget caps the tokens the goal may spend. K and M work as suffixes. Change it later with /goal budget=1M, remove it with /goal budget=clear.
Manage it
| Command | What it does |
|---|---|
/goal | Show the current goal and its status |
/goal <objective> | Set a new goal |
/goal pause | Pause the automatic continuation |
/goal resume | Resume a paused or blocked goal |
/goal edit | Edit the objective |
/goal clear | Remove the goal |
/goal help | Syntax and budget examples |
Write good goals
- Describe the result, not the steps: "every listing can be booked" beats "add a button".
- Say how to verify it: "with tests", "the build passes", "the docs mention it".
- Combine it with Subagents for big lists: one goal, several agents.
Common questions
How do I set a goal?
Use the command /goal followed by the objective, for example /goal Every listing can be booked online, with tests. A goal keeps Alran working across turns until it is complete or until it is blocked and needs you, and a banner shows the goal and its status the whole time.
How do I limit the tokens a goal may spend?
Give the goal a budget, for example /goal Migrate the API to v2 budget=500K, where K and M work as suffixes. Change it later with /goal budget=1M and remove it with /goal budget=clear.
How do I write a good goal?
Describe the result instead of the steps, say how you can verify it, and combine it with subagents for big lists. The command /goal help shows the syntax and budget examples.