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

# Missions

> Give Replit a persistent goal, agree on success criteria, set a budget and boundaries, and follow progress from mission planning through completion in your chat.

A mission gives a chat a persistent goal.

Before work begins, you and Replit define:

* **Approach**: How Replit will tackle the work.
* **Success criteria**: The outcomes that count as completion.
* **Budget**: The maximum Replit AI usage for the mission.
* **Boundaries**: Actions that require your approval or must not be taken.

Replit uses that agreement to guide its work and evaluate the result.

For example, you could ask Replit:

* “Fix these 25 problems reported by my customers. Test each fix and summarize anything that still needs attention.”
* “Improve my slide importer so imported presentations look like the original PowerPoint slides. Agree on how closely they should match, then compare the results and keep improving until they meet that target.”

## Start a mission

Ask Replit to start a mission in a chat, or type `/mission` followed by your goal.
Replit guides you through planning before execution starts. Questions adapt to
your goal and the information you have already provided.

**1. Choose your planning depth**

![Planning a mission with Only the essentials and Work through the details options](https://mintcdn.com/replit/-ao0lE7PHO7oQ4sA/images/missions/planning.png?fit=max\&auto=format\&n=-ao0lE7PHO7oQ4sA\&q=85\&s=84f9cf75196c2582af8e57274c057750)

The steps below show **Work through the details**. **Only the essentials** uses
fewer questions before presenting the agreement for review.

**2. Understand**

Clarify what you want to accomplish, why it matters, and what you are
starting with. Your answers help Replit define the scope of the mission.

![Understand stage asking what matters most for the first version](https://mintcdn.com/replit/-ao0lE7PHO7oQ4sA/images/missions/understand.png?fit=max\&auto=format\&n=-ao0lE7PHO7oQ4sA\&q=85\&s=aaac88228fd84c92aff4b4d727f6c268)

**3. Approach**

Decide how Replit should tackle the work. Review the suggested approaches,
select the one that fits your needs, or describe your own.

![Approach stage showing suggested ways to organize the work](https://mintcdn.com/replit/-ao0lE7PHO7oQ4sA/images/missions/approach.png?fit=max\&auto=format\&n=-ao0lE7PHO7oQ4sA\&q=85\&s=5d3aab5399d59e0a24858baba9c4af3e)

**4. Success**

Define the outcomes that count as completion. Choose criteria that can be
checked against the result, rather than only listing activities to perform.

Replit uses these criteria to guide the work and evaluate whether the mission
has achieved its goal.

![Success stage with selected outcomes for the mission](https://mintcdn.com/replit/-ao0lE7PHO7oQ4sA/images/missions/success.png?fit=max\&auto=format\&n=-ao0lE7PHO7oQ4sA\&q=85\&s=277d6aef6daf57025647ccae0d125f3e)

**5. Boundaries**

Set your maximum Replit AI usage budget in USD and select the model for the
mission. Specify which actions Replit must ask you about first and which
actions it must never take.

Work already running can take AI spending slightly over the budget before it
stops. The budget does not guarantee that the mission will succeed within
that amount.

![Boundaries stage with the maximum AI usage budget and model selector](https://mintcdn.com/replit/-ao0lE7PHO7oQ4sA/images/missions/boundaries.png?fit=max\&auto=format\&n=-ao0lE7PHO7oQ4sA\&q=85\&s=9e8368d5a79b0c19d4f0d14fdad23f5d)

**6. Review and start**

Review the **Mission contract** in the side panel. Check the goal, approach,
success criteria, budget, and boundaries.

Ask Replit to revise anything that is missing or incorrect. When you are
ready, select **Confirm and start**. A contract marked **Draft** has not
activated the mission.

![Draft Mission contract showing the agreement, budget, and Confirm and start button](https://mintcdn.com/replit/-ao0lE7PHO7oQ4sA/images/missions/contract.png?fit=max\&auto=format\&n=-ao0lE7PHO7oQ4sA\&q=85\&s=ec888059d7927a18136b41d51b80f8bd)

## Follow progress

Replit works toward the mission's milestones and reports progress as work
proceeds. It may request a decision, approval, or access to a connected service
before continuing.

A mission can wait for your input or for scheduled work to resume. Its goal
remains active while it waits, even though Replit is not executing work at that
moment. The goal stays attached to the chat across turns and sessions.

## Review completion

When Replit attempts to finish, an automated evaluator checks the available
evidence against the mission's success criteria. It can accept completion or
return feedback identifying work that remains.

When the mission is complete, Replit displays **Mission complete** in the chat.
Open the **Mission report** to review the result.

![Mission complete status above a Mission report card in the chat](https://mintcdn.com/replit/-ao0lE7PHO7oQ4sA/images/missions/completion.png?fit=max\&auto=format\&n=-ao0lE7PHO7oQ4sA\&q=85\&s=2b3fdc8c9aab8c217e64e387fdd9590d)

Automated completion is not a guarantee that the result is correct or meets your
expectations. Review the deliverable against your agreed success criteria and
tell Replit about any unmet requirements.

## Change the agreement

Ask Replit to revise the mission when your needs change. Replit can adapt its
approach as it learns.

Make changes to your goal, success requirements, permissions, or budget explicit.
Review the updated contract to see the current agreement.

## Clear a mission

Ask Replit to clear the mission. Replit asks you to
confirm before removing the ongoing goal.

Clearing a mission and stopping execution are different actions. Clearing the
goal does not cancel background processes or reverse actions already taken.
If you also need ongoing work stopped, explicitly ask Replit to identify and
stop that work. Review its response for operations it could not stop.
