Auto-continue: Auto-Resume After Quota Resets
Arm Auto-continue on a Claude Code or Codex session and CodeMantis automatically resumes the same task about a minute after your usage quota resets — no waiting, no manual nudge.
Overview
Auto-continue keeps a long task moving across a usage limit. When a Claude Code or Codex session runs out of quota mid-task, CodeMantis can schedule a one-shot job that automatically prompts that same session to pick up where it left off, about a minute after the quota window resets — so you don't have to wait out the reset and then remember to nudge the agent yourself.
It's a per-session switch, off by default: you arm it on each session you want to babysit.
What You See
The toggle. In the composer header row, immediately to the left of the Handover button, is an Auto-continue toggle — a TimerReset icon, the label "Auto-continue", and a small status dot (lit when on, dim when off). Hovering it shows a tooltip that explains what it will do. The toggle appears only on Claude Code and Codex sessions; it's hidden on OpenCode sessions (see Scope below).
The armed card. Once a continuation has been scheduled, a calm "Auto-continue armed — resumes around HH:MM" card appears above the composer. It sits alongside the yellow Handover card rather than replacing it — both are valid responses to hitting a limit (hand the work to another agent now, or wait and auto-resume this one). The card's X cancels the scheduled continuation.
In the Scheduler. The pending continuation also shows in the Scheduler (Jobs) view, tagged with an Auto-continue badge. It's a one-shot job: it removes itself from the list once it has fired.
How to Access
| Method | Action |
|---|---|
| Composer header | Click the Auto-continue toggle (TimerReset icon), just left of the Handover button, to turn it on or off for the active session |
Auto-continue is per-session state — turning it on for one session does not affect any other session.
How Auto-continue Works
- You turn Auto-continue on for a session that is working through a long task.
- The session hits its usage/quota limit and stops.
- CodeMantis reads the quota-reset time and schedules a one-shot job for about one minute after the window reopens.
- When the job fires, it prompts the same session to continue, including a short recap instruction so the agent re-checks its current state before resuming rather than blindly carrying on.
Durable across restarts. The scheduled continuation is persisted, so it survives an app restart. If the quota window resets while CodeMantis is closed, the continuation fires on the next launch instead of being lost.
Scope
Auto-continue is available on Claude Code and Codex sessions only, because both report a reliable quota-reset time to schedule against. The toggle is hidden on OpenCode sessions.
In the Scheduler View
Armed continuations are ordinary scheduler jobs, so they appear in the Scheduler view alongside SpecWriter jobs. Each row carries:
- a type badge — Auto-continue, or Auto-start (with an alarm-clock icon) for the session warm-up job
- an enable/disable toggle
- last-run success/failure dots
- a Delete button
Long tasks that resume across multiple quota windows show a layered "part N pending" indicator marking the continuation chain.
States
| State | What it means |
|---|---|
| Off (default) | The status dot is dim and nothing is scheduled. Every session starts here. |
| On, waiting | The toggle is lit but nothing is scheduled yet — Auto-continue only arms when the session actually hits its limit. |
| Armed | A continuation is scheduled. The "Auto-continue armed — resumes around HH:MM" card shows above the composer and the job is listed in the Scheduler. The card's X, or turning the toggle off, cancels it. |
| Paused by the safety cap | After 3 consecutive automatic continuations with no message from you in between, Auto-continue stops arming and a toast tells you to send a message to re-enable it. Typing any message resets the counter and re-enables arming. |
Disarm conditions. A scheduled or armed continuation is cleared when you turn the toggle off, when the session completes a healthy turn (that is, you resumed it yourself), or when you close the session.
Configuration
| Setting | Default | Notes |
|---|---|---|
| Auto-continue toggle | Off | Per-session switch in the composer header (TimerReset icon). Each session is armed independently — there is nothing to set up ahead of time. |
| Tooltip | On hover | Hovering the toggle explains the behavior in place. |
Safety cap. After 3 consecutive unattended continuations, Auto-continue stops arming until you send a message. The cap is fixed at three and can't be changed — it's a built-in guard, not a user setting. Sending any message resets the counter.
Tips
- Turn Auto-continue on before you step away from a long task that is likely to cross a quota reset — it resumes the work for you about a minute after the window reopens.
- Auto-continue and Handover are complementary: the armed card and the yellow Handover card appear together, so you can still hand the task to another agent instead of waiting for the reset.
- If Auto-continue pauses itself after three unattended rounds, just send the session a message — that resets the safety counter and lets you steer before it continues.
Related Articles
- Rate Limiting & Usage — What quota limits are, how reset windows work, and what Auto-continue schedules against
- Per-Task Agent Routing — How Claude Code and Codex sessions are assigned, and how Handover moves work to another agent
- Self-Drive: Autonomous Implementation — Run long, multi-session tasks automatically — a natural companion to Auto-continue
- Context Meter & Token Management — Track usage before a session hits the wall
- Session Frozen — Diagnose a session that has stopped responding
- Settings Reference — All CodeMantis settings in one place
Recall: Project & Cross-Project Memory
An opt-in memory layer that composes a focused brief from your project's Markdown vault before each prompt and harvests one memory note per commit — so decisions, gotchas, and conventions persist across sessions instead of being re-explained every time.
Project Picker & Templates
Open, clone, scaffold, or resume a project — five tabs in one picker, including the new Resume Session tab.