---

RazTodo is a lightweight and cross-platform CLI tool for efficient todo and task management, using SQLite as its storage backend.

Preview

Features

• Task Management — Add, update, remove, list, and mark tasks as done, clear tasks
• Tags & Projects — Organize tasks with tags and project names
• Search — Full-text search across all tasks
• Due Dates & Priority — Set deadlines and priority levels L | M | H
• Import/Export — Backup and restore tasks via JSON
• Colored Output — Beautiful ANSI colors and icons
• SQLite Storage — No external services required
• Cross-Platform — Works on Linux, macOS, and Windows
• Fast Performance — Lazy loading and optimized architecture
• Clean Architecture — Maintainable and testable codebase

---

Quick Start

Installation

# Recommended for CLI usage
pipx install raztodo

# Or install via pip 
pip install raztodo

For more installation options, see Installation Guide

Basic Usage

# Create a task
rt add "Buy groceries" --priority H --due 2024-12-31

# List all tasks
rt list

# Mark as done
rt done 1

# Search
rt search "groceries"

For complete command reference, see Usage Guide

---

Commands

Command	Description
add	Create a new task
list	List tasks with filters
update	Update a task
done	Mark task as done/undone
remove	Delete a task
search	Search tasks
export	Export to JSON
import	Import from JSON
migrate	Run database migration
clear	Delete all tasks

# Get help for any command
rt --help
rt add --help

---

Configuration

Variable	Description	Default
RAZTODO_DB	Database path	tasks.db
LOG_LEVEL	Logging level	ERROR

For detailed configuration, see Configuration Guide

---

Documentation

• Installation Guide — Install via pip, pipx, or from source
• Usage Guide — Complete command reference
• Configuration — Environment variables and options
• Architecture — Project structure and design
• Testing — Running tests and contributing
• Changelog — Release notes and version history

---

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Run quality checks:

   pytest
   ruff check src/ tests/
   black --check src/ tests/
   mypy src/

4. Submit a pull request

For detailed guidelines, see Contributing Guide.

---

License

MIT License