# Autopilot and limits

The Autopilot and limits settings, their defaults, and the plan's credits.

## Prerequisites

- The project is open. The section is **Settings → Autopilot and limits**. The same card is in the setup wizard.

## Steps

The card says "One setting for what can ship after the client approves. Protected files always wait for you."

Pick one mode. **Standard** is marked **Recommended**. A new project is stored as **Aggressive**, so that choice is already selected and the **Advanced** disclosure is open.

- **Off**. "Every change waits for you." Nothing auto-merges. You press **Approve & merge** after the client approves.
- **Safe**. "Text, styles, and links." Only a trivial change can auto-merge.
- **Standard**. "Also new pages, long copy, and small UI additions." Trivial and standard changes can auto-merge.
- **Aggressive**. "Same scope as Standard, with a higher file and line cap." Shown under **Advanced**.

After the client presses **Looks good**, an eligible change is squash-merged. These always wait for you, in every mode:

- A protected path. The request shows "Protected path:" and the path.
- A deleted file. The request shows "Deleted file:" and the filename.
- A change over the file or line cap for that mode.
- More than **Max auto-merges per day** already shipped that day.
- A preview that is not on the latest commit, or a request with no pull request.

Caps used when deciding a merge:

| Mode | Files | Lines in existing files | Lines in new files |
| --- | --- | --- | --- |
| Safe | 5 | 200 | 300 |
| Standard | 8 | 200 | 1500 |
| Aggressive | 12 | 400 | 3000 |

**Off** uses the Safe caps for size checks and still does not ship.

The other fields, and the values a new project starts with:

- **Max auto-merges per day**. Default 10. Allowed 1 to 100.
- **Quote validity (days)**. Default 14. Allowed 1 to 90. This is how long a sent quote stays valid.
- **Max spend per run (USD)**. Default 1.00. Allowed 0.25 to 5. This caps what one agent run may cost.
- **Max duration (minutes)**. Default 10. Allowed 2 to 20.
- **Monthly request cap**. Empty by default, placeholder **No cap**. The hint is "Limits how many requests this client can send per month." Leave it empty for no cap. A value must be a positive whole number. Saving anything else returns "Monthly cap must be a positive whole number, or empty."

The cap counts non-test requests created on this project since the start of the UTC month. A new conversation still open from the last 30 minutes counts too, until it becomes a request. Continuing that same conversation does not count again. An adjustment on an existing request does not count. Test requests do not count. When the cap is already reached, the widget refuses a new request and says "You've reached this month's request limit. Your team can raise it." French: "Vous avez atteint la limite de demandes de ce mois. Votre équipe peut l'augmenter." The widget shows that sentence in the client's language, then the code [MDF-PLAN-004](https://www.modifee.com/docs/errors/MDF-PLAN-004), the same way it shows [MDF-AUTH-002](https://www.modifee.com/docs/errors/MDF-AUTH-002) next to the not-allowed sentence.

Press **Save** on the card.

### Requests this month and plan credits

The project overview shows **Requests this month**. That count is separate from **Monthly request cap**. Beside it, **AI spend this month** is the summed cost of usage on that project, including dictation.

The plan allowance is credits, under **Settings → Plan & usage**, section **Credits**.

| Plan | Included credits each month |
| --- | --- |
| Free | 15 |
| Beta | 150 |
| Starter | 150 |
| Studio | 600 |
| Agency | 2000 |

The page says "Small edits use 1 credit, bigger changes like new pages use more." A finished agent run costs at least 1 credit. Paid plans (Starter, Studio, Agency) can go over the included amount at $0.60 per extra credit, and unused included credits roll over for one month. Free and Beta do not. The line is "This plan does not bill extra credits. Requests wait until credits are available."

**Included remaining**, **Rollover**, and **Overage this period** are on that page. **Monthly spend cap (USD)** starts at 100. Clear the field and press **Save cap** to remove it. An empty field means no cap. The placeholder is **No cap**.

## Verify

The selected mode matches what you saved. After a client presses **Looks good** on a small text change, **Safe**, **Standard**, and **Aggressive** can move it to **Merged** without **Approve & merge**. **Off** leaves it on **Needs your merge**.

**Plan & usage** shows the included credits for the current plan.

## Troubleshooting

- The section mark is yellow. The tooltip is one of: "Daily auto-merge limit must be between 1 and 100", "Quote validity must be between 1 and 90 days", "Max spend per run must be between $0.25 and $5", "Max duration must be between 2 and 20 minutes".
- Saving the spend field outside 0.25 to 5 returns "Max cost per run must be between $0.25 and $5."
- A change stayed on **Needs your merge** with **Review required**. Read the reason list. Protected paths and deleted files do not auto-merge. See [Guardrails](https://www.modifee.com/docs/agency/guardrails).
- Home says "No credits left this period" or "Credits are running low". Open **Plan & usage**. See [Health indicators](https://www.modifee.com/docs/agency/health-indicators).