Auto Run Workflow

Fresh

End-to-end guide for using Auto Run to execute tasks autonomously.

Complete Workflow

Step 1: Create Task Documents

Write markdown checklists with specific, actionable tasks:

# API Feature Implementation

- [ ] Create new endpoint POST /api/users with input validation
- [ ] Add authentication middleware to protect the endpoint
- [ ] Write integration tests covering success and error cases
- [ ] Update OpenAPI spec with the new endpoint documentation

Task Quality

Be specific and actionable. "Implement auth" is vague. "Add JWT token validation middleware to /api/users endpoint" gives the AI clear direction.

Step 2: Configure Auto Run

1. Open Auto Run tab (Ctrl+Shift+1)
2. Select your task document folder
3. Choose documents and set order

Run Options Decision

Scenario	Options
One-time tasks	Single document, no special options
Iterative work	Reset on Completion (preserves original)
Continuous monitoring	Loop Mode
Code changes	Dispatch to Worktree
Multiple task sets	Multi-document with ordering

Step 3: Execute

Click Run. Each task spawns a fresh session — no context bleed.

Monitor progress:

• Auto Run tab shows current task
• History panel logs completions with session ID, duration, cost

Step 4: Review

1. Open History (Ctrl+Shift+H)
2. Filter by AUTO entries
3. Click session ID to jump to the conversation
4. Verify work quality
5. Toggle Validated flag for reviewed items

Step 5: Ship (If Using Worktree)

1. Right-click worktree agent → Create Pull Request
2. Review the auto-generated PR
3. Merge and remove worktree

See Also

• Auto Run & Playbooks — Feature reference
• Inline Wizard — Auto-generate task documents
• Git Worktrees — Isolate changes