DEEN

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?

text
/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.

text
✓ Goal complete · 1h20min0s · 1.1M tokens · 3 turns

Give it a budget

text
/goal Migrate the API to v2 budget=500K

The 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

CommandWhat it does
/goalShow the current goal and its status
/goal <objective>Set a new goal
/goal pausePause the automatic continuation
/goal resumeResume a paused or blocked goal
/goal editEdit the objective
/goal clearRemove the goal
/goal helpSyntax 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.