Projects

Projects

Organize related tasks into projects for better management.

---

Overview

Projects are containers for related tasks. They appear in the sidebar and allow you to:

• Group tasks by area (Work, Personal, Home)
• Filter to see only relevant tasks
• Track progress across related items

---

Creating Projects

1. Press P (capital P)
2. Enter the project name
3. Press Enter

The project appears in the sidebar under "Projects".

---

Editing Projects

1. Press h to focus the sidebar
2. Navigate to the project with j/k
3. Press E (capital E)
4. Modify the name
5. Press Enter to save

---

Deleting Projects

1. Press h to focus the sidebar
2. Navigate to the project
3. Press X (capital X)
4. Confirm deletion

Note: Deleting a project only unassigns its tasks—tasks are not deleted.

---

Assigning Tasks to Projects

When Creating

Use the @ syntax in Quick-Add-Syntax:

Fix bug @Backend
New feature @Frontend

After Creation

1. Select a task
2. Press m (move)
3. Choose the destination project
4. Press Enter

---

Viewing Project Tasks

1. Press h to focus sidebar
2. Navigate to a project
3. Press Enter to select

The task list filters to show only that project's tasks.

---

Project Status

Projects have their own lifecycle:

Status	Description
Active	Currently being worked on
On Hold	Temporarily paused
Completed	All work finished
Archived	No longer relevant

---

Bulk Move to Project

Move multiple tasks at once:

1. Press v to enter multi-select mode
2. Select tasks with Space
3. Press m to move
4. Choose destination project
5. Press Enter

---

Projects in Dashboard

The Dashboard shows project progress:

• Completion percentage per project
• Task counts
• Visual progress bars

---

Tips

1. Use consistent naming - "Work" not "work" or "WORK"
2. Keep it simple - A few well-defined projects work better than many
3. Use tags for cross-cutting concerns - Tags work across projects

---

Keybindings

Key	Action
P	Create project
E	Edit project (sidebar)
X	Delete project (sidebar)
m	Move task to project

---

See Also

• Task-Management - Working with tasks
• Tags - Cross-cutting organization
• Views-and-Filtering - Filtering options
• Dashboard - Project statistics