Kanban Board
Each project has a dedicated task board with three columns:- Todo — Tasks waiting to be started
- In Progress — Active work
- Done — Completed tasks
Drag and Drop
Move tasks between columns by dragging task cards. CodeFire automatically:- Updates task status
- Records completion timestamp when moved to Done
- Clears completion timestamp when moved back to Todo or In Progress
Creating Tasks
CodeFire offers multiple ways to create tasks:Manual Creation
- Click New Task button in the task board toolbar
- Enter title and description
- Set priority (None, Low, Medium, High, Critical)
- Add labels (Bug, Feature, Enhancement, Docs, Refactor, Test)
- Click Create
Email Integration
Connect your Gmail account to automatically extract tasks from emails:- Go to Settings → Gmail
- Enter Google OAuth credentials (Client ID + Secret)
- Authorize CodeFire to read emails
- CodeFire uses AI to extract actionable tasks from your inbox
Email-derived tasks include the original email content in the description, making it easy to reference later.
AI-Powered Creation
Your AI agent can create tasks through the MCP server:- Creating tasks with title, description, priority, labels
- Updating task status
- Adding notes to existing tasks
- Querying tasks by status or project
Task Details
Each task stores:- Title and description
- Status (todo, in_progress, done)
- Priority (0-4, with color coding)
- Labels (multiple tags for categorization)
- Timestamps (created, completed)
- Source (manual, email, AI-created)
- Project (or global if not tied to a specific project)
- Attachments (file paths for screenshots or related files)
Priority Levels
- Critical (🔴 Red) — Urgent, blocking work
- High (🟠 Orange) — Important, near-term
- Medium (🟡 Yellow) — Standard priority
- Low (🟢 Green) — Nice to have
- None (⚪ Gray) — No priority set
Global Task Board
The home view includes a global task board that aggregates tasks from all projects:- See all open work across every project
- Filter by project using badges on each task
- Click a project badge to jump to that project’s window
- Drag tasks between columns (works across projects)
Launching Tasks as Claude Sessions
CodeFire can turn any task into a new Claude Code session:- Right-click a task
- Select Launch as Claude Session
- CodeFire opens a new terminal tab and runs:
Task History
CodeFire maintains full history for each task:- When it was created and by whom (manual, email, AI)
- Status changes (todo → in_progress → done)
- Notes added over time
- Sessions where the task was referenced
Best Practices
Use priority levels consistently
Use priority levels consistently
Establish a team convention for priority levels. For example: Critical = production bugs, High = sprint goals, Medium = backlog, Low = tech debt.
Label tasks by type
Label tasks by type
Use labels to categorize work: Bug, Feature, Enhancement, Docs, Refactor, Test. This makes filtering and reporting easier.
Keep task descriptions detailed
Keep task descriptions detailed
Add acceptance criteria, edge cases, and design links to task descriptions. Your AI agent can read this context when you launch the task.
Use global tasks for cross-project work
Use global tasks for cross-project work
Some tasks span multiple projects (infrastructure, tooling). Create global tasks for these.
MCP Integration
When the CodeFire MCP server is installed, your AI agent can:- List tasks: Query tasks by status, project, or globally
- Create tasks: Add new tasks with full metadata
- Update status: Move tasks between columns programmatically
- Add notes: Append notes to existing tasks
- Search tasks: Find tasks by keyword or label
Related Features
Project Management
Organize tasks within projects or view globally
Session Monitoring
Track which sessions referenced specific tasks
Notes
Document long-term context alongside task details
Terminal
Launch task sessions directly from the task board