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

# Goals

Piebald supports **goals**—loops that force the model to continue its task until it marks it complete.

## Usage

You can start a new goal with the `/goal <goal objective>` slash command.  The model can also start a goal itself by calling the `CreateGoal` tool.

Each time the model completes generation, Piebald automatically sends another user message with a goal-specific context notification reminding it to continue working or complete the goal.  The model can update the goal with a builtin tool, `UpdateGoal`, to mark it as complete or blocked.

The model can also get the goal details at any time using the `GetGoal` builtin tool.  This tool returns the original goal objective and the current state of the goal.

You can check on the progress of the goal by clicking the "Active goal" indicator in the chat bar at the top of the app:

<img class="shadow-md rounded-xl" width="500" alt="active_goal.png" src="https://mintcdn.com/piebald/lK9zVQ0FITXi-EDF/imgs/active_goal.png?fit=max&auto=format&n=lK9zVQ0FITXi-EDF&q=85&s=bc6a6d124dda6a2d4177833f75e6d544" data-path="imgs/active_goal.png" />

Chats with goals—active and complete—are displayed in the sidebar with a special goal indicator:

<img class="shadow-md rounded-xl" width="350" alt="chat_with_active_goal.png" src="https://mintcdn.com/piebald/lK9zVQ0FITXi-EDF/imgs/chat_with_active_goal.png?fit=max&auto=format&n=lK9zVQ0FITXi-EDF&q=85&s=97fac1fa3097f15a9f757e3a3b170bc7" data-path="imgs/chat_with_active_goal.png" />

<img class="shadow-md rounded-xl" width="350" alt="chat_with_completed_goal.png" src="https://mintcdn.com/piebald/lK9zVQ0FITXi-EDF/imgs/chat_with_completed_goal.png?fit=max&auto=format&n=lK9zVQ0FITXi-EDF&q=85&s=e3a138e4673aa2302f14738cffef9679" data-path="imgs/chat_with_completed_goal.png" />