> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mutagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Goals

> /goal keeps the agent working toward one objective until it is done, blocked, or out of the budget you set.

`/goal <goal>` puts the session in goal mode: the agent keeps taking turns toward the objective
until it completes it, hits a true blocker, or reaches a limit — instead of stopping at the end of
each reply and waiting for you.

```
/goal make the test suite pass, then update CHANGELOG.md
```

Bare `/goal` opens the manager for the current goal; subcommands work directly:

| Command                        | Does                                                           |
| ------------------------------ | -------------------------------------------------------------- |
| `/goal <goal>`                 | Start goal mode (asks before replacing an existing goal).      |
| `/goal status`                 | Where the goal stands.                                         |
| `/goal pause` · `/goal resume` | Stop and restart the automatic continuation.                   |
| `/goal edit`                   | Change the objective without losing progress.                  |
| `/goal clear`                  | Drop the goal.                                                 |
| `/goal --tokens 100k <goal>`   | Same, with a token budget — the run wraps up when it is spent. |

A goal ends one of five ways: **complete** (the agent has to claim completion explicitly, and
plainly contradictory claims are rejected), **blocked** (a concrete blocker that recurred across
turns — not a first failed attempt), **paused** (you interrupted), a provider **usage limit**, or
your **token budget**. By default the loop also pauses for review after 25 goal-driven responses,
so a stuck goal cannot burn tokens unattended forever.

The goal lives in the session: `/resume` the session and the goal state comes back with it.