Task Management
obx provides tools to manage Markdown checkbox tasks across your vault.
Task Format
Section titled “Task Format”Tasks are standard Markdown checkboxes:
- [ ] Open task- [x] Completed taskExtended Task Syntax
Section titled “Extended Task Syntax”Many users add metadata to tasks:
- [ ] Review PR #123 #work @john 📅 2024-03-15- [ ] Buy groceries #personal ⏰ 17:00- [x] Submit report ✅ 2024-03-10obx recognizes and preserves this syntax.
Task Tools
Section titled “Task Tools”manage-tasks action: “list”
Section titled “manage-tasks action: “list””List all tasks across your vault.
| Parameter | Type | Description |
|---|---|---|
status | string | Filter: all, open, completed (default: all) |
directory | string | Limit to specific directory |
Example prompts:
- “Show all my open tasks”
- “List completed tasks in projects/”
- “What tasks do I have?“
manage-tasks action: “toggle”
Section titled “manage-tasks action: “toggle””Toggle a task’s completion status.
| Parameter | Type | Description |
|---|---|---|
path | string | Path to the note |
line | number | Line number of the task (1-based) |
Example prompts:
- “Mark the third task in inbox.md as done”
- “Complete the task on line 15”
Common Workflows
Section titled “Common Workflows”Daily Task Review
Section titled “Daily Task Review”-
View open tasks
“Show me all open tasks”
-
Filter by context
“Just show tasks tagged with #work”
-
Complete tasks
“Mark the first three tasks as done”
-
Add new tasks
“Add a task to my inbox: Review quarterly report”
Inbox Processing
Section titled “Inbox Processing”Process tasks from a central inbox:
“Show tasks in my inbox, then help me distribute them to the right projects”
The AI will:
- List tasks from inbox.md
- Help categorize each task
- Move relevant tasks to project notes
- Keep inbox clean
Project Task Tracking
Section titled “Project Task Tracking”Track tasks within a project:
“Show all tasks in my ‘Website Redesign’ project”
manage-tasks action: "list", directory: "projects/Website Redesign"Task Organization Patterns
Section titled “Task Organization Patterns”Centralized Inbox
Section titled “Centralized Inbox”Keep a single inbox for quick capture:
# Inbox
- [ ] Call dentist- [ ] Review PR #456- [ ] Research GraphQLProcess regularly with:
“Help me process my inbox - categorize tasks and move them to appropriate notes”
Project-Based Tasks
Section titled “Project-Based Tasks”Tasks live in project notes:
# Website Redesign
## Tasks- [ ] Create wireframes- [ ] Review with stakeholders- [x] Define requirements
## Notes...Daily Note Tasks
Section titled “Daily Note Tasks”Tasks in daily notes:
# 2024-03-15
## Tasks for Today- [ ] Morning standup- [ ] Code review- [ ] Deploy to stagingFinding Tasks
Section titled “Finding Tasks”By Tag
Section titled “By Tag”“Find all tasks tagged with #urgent”
Uses search-vault action: "search" with task checkbox pattern + tag.
By Project
Section titled “By Project”“Show tasks in the marketing project”
Uses manage-tasks action: "list" with directory filter.
By Date
Section titled “By Date”“Find tasks due this week”
Searches for date patterns in task text.
Overdue Tasks
Section titled “Overdue Tasks”“Find tasks with dates before today that aren’t completed”
The AI parses dates and filters results.
Task Metadata Patterns
Section titled “Task Metadata Patterns”Priority
Section titled “Priority”- [ ] 🔴 Critical bug fix- [ ] 🟡 Medium priority feature- [ ] 🟢 Nice to have improvementOr with tags:
- [ ] Fix login bug #p1- [ ] Add dark mode #p2Due Dates
Section titled “Due Dates”- [ ] Submit report 📅 2024-03-15- [ ] Call client due::2024-03-20Assignments
Section titled “Assignments”- [ ] Review code @john- [ ] Write docs @sarahContext Tags
Section titled “Context Tags”- [ ] Call dentist #personal #phone- [ ] Review PR #work #code-reviewAdvanced Task Queries
Section titled “Advanced Task Queries”Combine Conditions
Section titled “Combine Conditions”“Find all open tasks tagged #work that are due this week”
Group and Count
Section titled “Group and Count”“How many open tasks do I have per project?”
Find Stale Tasks
Section titled “Find Stale Tasks”“Show tasks that have been open for more than 30 days”
Task Reports
Section titled “Task Reports”Weekly Summary
Section titled “Weekly Summary”“Summarize tasks completed this week”
The AI will:
- Search daily notes for the week
- Find completed tasks
- Group by project/tag
- Generate summary
Project Progress
Section titled “Project Progress”“Show task completion progress for the Website Redesign project”
Total: 25 tasksCompleted: 18 (72%)Open: 7Integration with Dataview
Section titled “Integration with Dataview”If you use Dataview, tasks can have inline fields:
- [ ] Review code [due:: 2024-03-15] [priority:: high]Query with:
“Find tasks where priority is high”
Uses search-vault action: "inline-fields" to find matching tasks.
Best Practices
Section titled “Best Practices”Keep Tasks Atomic
Section titled “Keep Tasks Atomic”Bad:
- [ ] Redesign entire websiteGood:
- [ ] Create homepage wireframe- [ ] Design navigation component- [ ] Build responsive headerUse Consistent Syntax
Section titled “Use Consistent Syntax”Pick a format and stick with it:
✓ - [ ] Task #tag 📅 date✗ - [ ] Task (tag) - date✗ - [ ] Task, tag, dateRegular Processing
Section titled “Regular Processing”- Process inbox daily
- Review projects weekly
- Archive completed tasks monthly