Use a goal to keep working toward one result across turns. Use a bounded loop to repeat a task at an interval while the session is running.
Set a goal
Give the objective, scope, and completion check:
An active goal switches to Act mode and enables automatic approvals. Include any prohibited changes in the objective, and review the work as it progresses.
Use /goal to inspect progress. The goal can be active, paused, blocked, or complete.
- Edit changes the objective and optional limit.
- Pause stops automatic continuation while preserving the goal.
- Resume continues unfinished work.
- Clear removes the goal from the conversation.
A goal pauses or stops when it reaches a limit, needs your input, or completes. Read the reason before resuming. Entering Plan mode suspends automatic continuation.
Create a bounded loop
Run /loop to open the designer. Choose the task, workload, cadence, maximum iterations, and completion condition. Review the plan before starting it.
Choose the workload that matches the job:
- Research and report: inspect code, documentation, or the web.
- Update a plan: maintain plan documents in Plan mode.
- Edit software: make source edits in Act mode.
- Observe hardware: inspect status and existing observations in Debug mode.
Loops cannot run shell commands, flash hardware, send device commands, or perform live captures. Use them for repeated inspection or scoped edits, and use a hardware script for a soak test or long measurement.
Set an interval and stopping condition
The designer offers intervals of 5 minutes, 15 minutes, or 1 hour, and limits of 3, 10, or 24 iterations. A loop expires three days after creation even if it has not reached its iteration limit.
For example, ask for a research loop that checks whether a known issue has new evidence and stops when the answer is complete.
Manage an existing loop
Run /loop again to see its plan, progress, next run, and pause, resume, or stop controls.
A busy session delays the next iteration. Repeated failures, a required decision, or a change to the project or mode can pause the loop. Resolve the reported issue before resuming. Last modified on September 12, 2026