Skip to content

User Guide ​

This guide covers the essential workflows and features to help you get the most out of TaskTrove.

Quick Task Creation ​

Press n or CTRL+n anywhere in the app to open the quick add dialog. TaskTrove understands natural language for dates:

Buy groceries tomorrow at 2pm

This creates a task with the title "Buy groceries" and schedules it for tomorrow at 2:00 PM.

Quick Add Shortcuts ​

While typing, use these patterns:

  • Due dates: tomorrow, next Friday, in 3 days, Dec 25
  • Recurring - daily, every sat, every 3 days
  • Times: at 2pm, at 14:30
  • Priorities: p1 (highest) to p4 (lowest)
  • Projects: #project-name or select from the dropdown
  • Labels: @label-name or select from the dropdown
  • Time estimates: ~2h, ~30m
  • Need full syntax? See Smart Parsing for all supported phrases (dates, repeats, projects, labels, priority, estimates, etc.).

Adding Details ​

Before saving, click the buttons to add:

  • Subtasks - Break down complex tasks
  • Comments - Add notes and context
  • Labels - Tag and categorize

Organizing with Projects ​

Projects help you group related tasks. Each project can have multiple sections to further organize work.

Creating Projects or Groups ​

  1. Click the + button in the sidebar
  2. Select "Project" or "Group"
  3. Give your project or group a name and optional color
  4. Save, and the new project/group will appear in the sidebar

Editing Projects or Groups ​

  1. Hover over the project or group
  2. Click the context menu button
  3. Select "Edit name" or "Change color"

Moving Projects ​

If you want to move a project to a different group:

  1. Hover over the project
  2. Drag and drop to a different group

Views Options ​

Switch between different views to match your workflow:

  • List View - Traditional task list with filters and sorting
  • Kanban Board - Drag tasks between sections (project view only)
  • Calendar View - See tasks on a calendar by due date

Display Options ​

Click the view options icon on the top right corner of the app:

  • Sort by: Due date, priority, creation date

Filtering ​

Filtering button can be found on the same row as "Add Task" button, just above the first task.

Working with Tasks ​

Keyboard Shortcuts ​

  • n - Quick add task
  • / - Search tasks
  • Space - Complete/uncomplete task
  • Esc - Close dialogs

Task Actions ​

Right-click (or click the ⋮ menu) on any task to:

  • Duplicate - Copy all attributes including subtasks
  • Delete - Remove the task

Drag and Drop ​

  • Drag tasks to reorder within a section (applicable only to tasks within a project)
  • Drag tasks between sections (in project view)

Comments and Collaboration ​

Add comments to tasks to:

  • Track progress and updates
  • Document decisions
  • Leave notes for later

Click the comment icon or open task details to add and view comments. Comments support inline editing - just click the pencil icon.

Language Support ​

TaskTrove is available in multiple languages:

  1. Click your profile icon
  2. Select "Settings"
  3. Choose your preferred language

API Access ​

For programmatic access to your tasks:

  1. Go to Settings → General
  2. Find the API Token section
  3. Click "Generate Token"
  4. Copy and save your token securely

Use the token with the /api/v1/* endpoints. See API Documentation for details.

Tips for Productivity ​

Capture Tasks Quickly ​

Use the quick add button in the sidebar to quickly capture new tasks with natural language. Any tasks that are not assigned to a particular projects will show up in Inbox.

Use Recurring Tasks ​

For habits and routines, set up recurring tasks:

  • Daily standup
  • Weekly reviews
  • Monthly reports

Filter and Focus ​

Use filters to focus on what matters:

  • Today's tasks
  • This week's tasks
  • High priority items
  • Filter by labels