Docs/Work Mode

Work Mode

Let your AI agent autonomously pick tasks from your queue and complete them while you focus on other things.

What Is Work Mode?

Work Mode turns your agent into an autonomous worker. Instead of waiting for you to start conversations, your agent:

  • Looks at your task queue and picks the highest-priority item
  • Works on it independently, using tools, reading files, and making progress
  • Pauses if it needs your input (approval, clarification, credentials)
  • Marks tasks complete when done, then moves to the next one
🤖
Autonomous Execution

Think of Work Mode like a teammate who checks the backlog, picks tasks, and works through them without needing constant supervision. You stay in control — but you don't have to micromanage.

How It Works

When you enable Work Mode, your agent follows this loop:

1
Check Priority Queue

Your agent scans tasks marked as "ready to work" and picks the highest priority one.

2
Execute Task

The agent works through the task: reading files, running commands, writing code, searching the web, etc.

3
Pause If Blocked

If the agent needs your input (approval, credentials, clarification), it pauses and notifies you.

4
Mark Complete & Continue

Once done, the agent marks the task complete, updates your task board, and picks the next task from the queue.

This loop continues until there are no more tasks in the queue, or you pause Work Mode manually.

Status Indicators

The Work Mode panel shows your agent's current state in real-time:

Idle

Work Mode is on, but there are no tasks in the queue. Your agent is waiting for work.

Working

Your agent is actively working on a task. You'll see live updates in the activity log.

Blocked

Your agent is waiting on you. Check the notification to see what it needs (approval, input, etc.).

Paused

Work Mode is paused. Your agent won't pick new tasks until you resume.

Activity Log

The Activity Log shows everything your agent does in Work Mode:

Recent Activity
Completed: "Refactor auth module"
2 minutes ago • 3 files changed
Working on: "Write tests for user service"
Started 30 seconds ago
Queued: "Update API documentation"
Priority: Medium

Click any activity item to open the full conversation and see exactly what your agent did.

Best Practices for Task Definitions

To get the most out of Work Mode, write clear, actionable tasks:

✅ Good Task Definitions
"Refactor the user authentication module to use JWT instead of sessions"
"Write unit tests for the payment processing service"
"Update the README with instructions for local development setup"
"Fix bug: login button not working on mobile Safari"
"Deploy version 2.1.0 to staging environment"
❌ Vague Task Definitions
"Fix the app" — Too broad, agent doesn't know where to start
"Make it better" — No clear success criteria
"Think about refactoring" — Not actionable, just exploratory
"Work on the backend" — Too vague, no specific goal

The more specific the task, the better your agent can execute autonomously without getting blocked.

Safety & Control

Work Mode is powerful, but you're always in control:

⏸️
Pause Anytime

Click "Pause Work Mode" to stop your agent mid-task. It will finish the current action and wait for you.

🛡️
Requires Approval

Destructive actions (deleting files, deploying, git push) require your explicit approval — even in Work Mode.

📝
Full Audit Log

Every action your agent takes is logged and reviewable. See exactly what changed and when.

🔄
Rollback Support

If your agent makes a mistake, you can review the changes and roll back if needed (e.g., via git).

When to Use Work Mode

Work Mode is ideal for:

  • Batch processing: Refactoring multiple files, writing tests, updating docs
  • Overnight work: Let your agent work on tasks while you sleep or focus elsewhere
  • Parallel execution: Your agent handles backlog tasks while you work on something else
  • Automated workflows: Paired with automations, Work Mode can handle routine tasks automatically
💡

Pro tip: Start with a small, well-defined task to see how Work Mode performs, then gradually add more tasks to the queue as you build confidence.

Questions about Work Mode?

Join our community or reach out — we're here to help.