-
Notifications
You must be signed in to change notification settings - Fork 0
Tags
Flexible labels for cross-cutting task organization.
Tags are labels that can be applied to any task, regardless of project. Use them for:
- Categories:
#bug,#feature,#docs - Contexts:
@work,@home,@errands(GTD-style) - Priority markers:
#urgent,#someday - People:
#john,#team
Tags starting with @ are context tags, following the GTD (Getting Things Done) methodology. They indicate where or when a task can be done:
| Context | Use Case |
|---|---|
@home |
Tasks requiring home environment |
@work |
Office or work-related tasks |
@errands |
Tasks done while out |
@phone |
Calls to make |
@computer |
Digital tasks |
@waiting |
Waiting for someone else |
The sidebar shows a "Contexts" section listing all @ tags in use. Click or navigate to filter by context.
When you're at home, filter by @home to see only tasks you can actually do. This reduces cognitive load and helps you focus on actionable items.
Use #tag in Quick-Add-Syntax:
Fix login bug #bug #security
- Select a task
- Press
T - Enter comma-separated tags:
bug, security, backend - Press
Enter
- Select a task
- Press
T - Enter the new tag list
- Press
Enter
Note: This replaces all existing tags. To clear tags, submit empty input.
- Press
# - Enter tag(s) to filter:
bugorbug, urgent - Press
Enter
Tasks matching any of the specified tags are shown.
Press Ctrl+t to remove the tag filter and show all tasks.
Tags appear after the task title:
[ ] Fix login issue #bug #backend
A task can have any number of tags:
Review security update #security #review #urgent #backend
The Reports view shows tag usage:
- Most used tags
- Completion rate per tag
- Tag frequency chart
Tags are sorted by count, with alphabetical sorting for equal counts.
-
Keep tags short -
#bugnot#this-is-a-bug -
Be consistent - Use
#meetingnot sometimes#meetings - Don't over-tag - 2-4 tags per task is usually enough
- Use for cross-cutting concerns - Projects for grouping, tags for categories
| Category | Examples |
|---|---|
| Type |
#bug, #feature, #docs, #chore
|
| Area |
#frontend, #backend, #api, #ui
|
| Priority |
#urgent, #important, #someday
|
| Context |
#work, #home, #errands
|
| People |
#john, #team, #client
|
Select "Untagged" from the sidebar to see tasks without any tags.
| Key | Action |
|---|---|
T |
Edit tags |
# |
Filter by tag |
Ctrl+t |
Clear tag filter |
- Quick-Add-Syntax - Creating tasks with tags
- Projects - Project-based organization
- Views-and-Filtering - All filtering options
- Reports - Tag statistics