Welcome to OpenTasks

OpenTasks is an AI-powered development task manager that connects to Cursor Cloud Agent to automate your coding tasks.

🎯

How It Works

Create a detailed ticket, drag it to the AI column, and receive a pull request. It's that simple.

🎫

Kanban Board

Drag-and-drop task management with visual status tracking

🤖

AI Integration

Cursor Cloud Agent implements features and creates PRs

🔀

Multi-Branch

Configure different branches for backend and frontend

The Workflow

1

Create Ticket

Write a detailed task description with clear acceptance criteria.

→

2

Drag to Handle

Move the ticket to the "Handle" column to trigger the AI agent.

→

3

AI Executes

Cursor Cloud Agent implements the feature and creates a PR.

→

4

Review & Merge

Review the AI-generated code and merge when satisfied.

┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   BACKLOG   │ ──▶ │   HANDLE    │ ──▶ │   REVIEW    │ ──▶ │    DONE     │
│             │     │  (AI Zone)  │     │   (Human)   │     │             │
│ Create task │     │ AI working  │     │ Review PR   │     │ Merged! 🎉  │
└─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘

Creating Effective Tickets

The AI agent needs clear, detailed instructions. Every ticket should include:

📝 Ticket Template

## What needs to be done
Describe the task clearly. What is the expected outcome?

## Acceptance Criteria
- [ ] Criterion 1
- [ ] Criterion 2
- [ ] Criterion 3

## Technical Details
Any specific implementation details, files to modify, or constraints?

## Additional Context
Links, screenshots, or references that might help.

Example: Good Ticket ✓

✓ Good

## What needs to be done
Add a dark mode toggle to the settings page that persists 
the user's preference across sessions.

## Acceptance Criteria
- [ ] Toggle switch visible in settings UI
- [ ] Saves preference to localStorage
- [ ] Applies theme immediately on toggle
- [ ] Smooth 200ms transition animation

## Technical Details
- Modify: src/components/Settings.tsx
- Add: src/hooks/useTheme.ts
- Use Tailwind's dark mode classes

Example: Bad Ticket ✗

✗ Bad

Add dark mode

Why it's bad: No context, no acceptance criteria, no technical details.

Multi-Branch Projects

OpenTasks supports projects with multiple branches — perfect for projects where backend and frontend live in different branches.

Setting Up Branch Presets

When creating or editing a project, configure your branch presets:

Default Branch: main

Branch Presets:
Backend=master
Frontend=frontend-dev

Using Branches

When creating a ticket, you'll see quick-select buttons for your configured branches:

Backend master

Frontend frontend-dev

The AI agent will create pull requests against the selected branch.

Tips for Best Results

🎯

Be Specific

Instead of "Add button", say "Add a primary blue button with rounded corners in the page header".

📁

Include File Paths

Tell the AI which files to modify: "Update src/components/Header.tsx".

🔍

Keep Scope Small

One feature per ticket. Large refactors often produce worse results.

📎

Add Context

Reference existing patterns: "Follow the same style as the UserCard component".

✅

Define Success

Clear acceptance criteria help the AI understand when the task is complete.

🧪

Mention Tests

If you need tests, say so: "Add unit tests for the new function".