Tasks
A Task is a unit of work shared between you and an agent. You trigger the task, the agent executes it, then you review or approve the results. Tasks can run on demand, on triggers, or on schedules.
What is a Task?
A Task is a unit of work that combines:
- Your instructions
- An agent's capabilities (model, rules, tools, prompt)
- Your codebase (repository and branch)
Tasks can be triggered manually, by events, or on a schedule, and can be assigned to anyone on your team for review.
Creating and Running a Task
1
Choose an Agent
Select the Agent you want to use for this task.
Don't have an Agent yet? Create one in Mission Control → Agents before setting up your first task.
2
Select Your Repository
Pick the repository and branch the Agent branch off of.
3
Describe the Task
Add your user input — clear instructions for what you want the agent to accomplish.
Example prompts:
Refactor unused React components and clean up imports
Add error handling to all API endpoints in the /api directory
Update README with installation instructions for the new CLI tool
4
Run the Task
Click the Submit button.
The Agent will:
- Analyze your repository and branch
- Execute the task based on your input
- Generate changes based on your task request
- Create a detailed session log
Task execution time varies based on complexity. You can monitor progress in your inbox.
5
Review Results
Each Task run creates a Session with complete traceability.
Review the diff carefully before accepting changes. You can:
- Accept all changes
- Request modifications
- Reject and retry with an updated input
Next Steps
Create a Workflow
Automate tasks with event-based triggers