Getting Started with TaskRepo¶

Welcome to TaskRepo! This guide will help you get up and running quickly.

What is TaskRepo?¶

TaskRepo is a TaskWarrior-inspired CLI tool that manages tasks as markdown files in git repositories. It combines the power of git version control with the simplicity of markdown, giving you a flexible and collaborative task management system.

Why TaskRepo?¶

Git-Backed: Full version history for all your tasks
Markdown: Simple, portable, human-readable task format
Collaborative: Share task repositories with your team
Powerful CLI: TaskWarrior-inspired commands and workflow
Flexible Organization: Multiple repositories for different projects

Installation Methods¶

TaskRepo supports multiple installation methods to fit your workflow:

macOS (Homebrew)¶

brew tap henriqueslab/formulas
brew install taskrepo

pipx (Recommended for Linux/Windows)¶

pipx install taskrepo

uv (Fast alternative)¶

uv tool install taskrepo

→ Full Installation Guide

Quick Start Path¶

Follow these steps to get started:

Install TaskRepo - Choose your installation method
Create Your First Task - Learn the basics
Explore Commands - Command reference

Next Steps¶

Once you're comfortable with the basics:

Task Management Guide - Learn advanced task management
Repository Management - Organize tasks across projects
Configuration - Customize TaskRepo to your workflow
Git Sync - Collaborate with your team