Skip to content

Quick Reference

Command Summary

Setup & Configuration

Command Description
tsk init Initialize TaskRepo configuration
tsk config Interactive configuration management
tsk config-show Show current configuration
tsk create-repo <name> Create a new task repository
tsk repos List all task repositories

Task Management

Command Description
tsk add Add a new task (interactive)
tsk list List tasks with optional filters
tsk search <query> Search tasks by text
tsk info <id> Display detailed task information
tsk edit <id> Edit one or more tasks
tsk done <id> Mark task(s) as completed
tsk in-progress <id> Mark task(s) as in progress
tsk cancelled <id> Mark task(s) as cancelled
tsk del <id> Delete task(s) permanently

Advanced Operations

Command Description
tsk ext <id> <duration> Extend task due date
tsk move <id> <repo> Move task(s) to different repository
tsk archive <id> Archive completed task(s)
tsk unarchive <id> Restore archived task(s)
tsk tui Launch interactive TUI

Git Operations

Command Description
tsk sync Sync all repositories
tsk sync --repo <name> Sync specific repository
tsk sync --no-push Pull only, don't push

Common Filters

All list/search commands support these filters:

Filter Example Description
--repo, -r --repo work Filter by repository
--status, -s --status pending Filter by status
--priority --priority H Filter by priority (H/M/L)
--project, -p --project backend Filter by project
--assignee, -a --assignee @alice Filter by assignee
--tag, -t --tag bug Filter by tag
--all --all Include completed/archived tasks

Task Statuses

  • pending - Not started (default)
  • in-progress - Currently being worked on
  • completed - Finished
  • cancelled - No longer relevant

Priority Levels

  • H - High priority
  • M - Medium priority (default)
  • L - Low priority

Date Formats

TaskRepo supports natural language dates:

  • today, tomorrow, yesterday
  • next week, next month, next year
  • ISO format: 2025-11-15
  • Natural: Nov 15, November 15 2025

For tsk ext, duration formats: - 3d - 3 days - 1w - 1 week - 2m - 2 months - 1y - 1 year

Batch Operations

Many commands support batch operations:

# Space-separated
tsk done 1 2 3

# Comma-separated
tsk done 1,2,3

# Works for: done, edit, del, move, archive, etc.

Examples

Create a high-priority bug

tsk add -r work -t "Fix memory leak" --priority H --tags bug,performance

List urgent pending tasks

tsk list --priority H --status pending

Extend task due date by 1 week

tsk ext 5 1w

Move tasks to different repository

tsk move 1,2,3 personal

tsk search "auth" --repo work

Aliases

You can use either command form:

  • tsk (short form, recommended)
  • taskrepo (full form)

Both are equivalent.

Environment Variables

Variable Purpose
EDITOR Default text editor for task descriptions
GOOGLE_ANALYTICS_KEY (Optional) Analytics tracking

Configuration File

Located at ~/.TaskRepo/config:

parent_dir: ~/tasks
default_priority: M
default_status: pending
default_assignee: null
default_editor: null
sort_by:
  - priority
  - due
cluster_due_dates: false

Interactive TUI

TUI Interface

Launch with tsk tui. Keyboard shortcuts:

Key Action
↑/↓ Navigate tasks
Tab Switch repositories
Space Select/deselect (multi-select)
Enter Mark as done
e Edit task
d Delete task
p Mark in-progress
c Mark cancelled
a Archive tasks
m Move to repository
s Sync with git
t Toggle tree view
/ Filter
q Quit

For LLM Assistants

Use this command to get LLM-friendly CLI reference:

tsk llm-info

Getting Help