---
title: "Goal Mode · Alran Code Docs"
url: https://alran.dev/en/docs/goal-mode
locale: en
updated: 2026-11-16
---

[Docs](https://alran.dev/en/docs)Working with Alran

# Goal Mode

Set a finish line. Alran keeps going, turn after turn, until it is met.

On this page

[How do I set a goal?](#set) [Give it a budget](#budget) [Manage it](#manage) [Write good goals](#tips) [Common questions](#faq)

## How do I set a goal? {#set}

```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 {#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 {#manage}

| 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 {#tips}

- 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](https://alran.dev/en/docs/subagents) for big lists: one goal, several agents.

## Common questions {#faq}

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.

[PreviousPlan Mode and permissions](https://alran.dev/en/docs/plan-mode) [NextSubagents and tasks](https://alran.dev/en/docs/subagents)
