FireTasks

Task management CLI in Rust with support for projects, tags, priorities, and due dates.

Features

• ✅ Complete task management (CRUD)
• 📁 Organization by projects
• 🏷️ Tag system
• ⚡ Priorities (Low, Medium, High, Critical)
• 📅 Due dates with overdue alerts
• 📊 Statistics and advanced filters
• 💾 JSON persistence
• 🎨 Colorized terminal interface

Installation

cd firetasks
cargo install --path .

Usage

Initialize

firetasks init

Add Task

firetasks add "Implement feature X" \
  --description "Create endpoint for feature X" \
  --priority high \
  --tags "backend,api" \
  --due "2026-05-10 18:00"

List Tasks

# List all
firetasks list

# Filter by status
firetasks list --status todo

# Filter by priority
firetasks list --priority high

# Filter by tags
firetasks list --tags "backend,api"

# Show only overdue
firetasks list --overdue

Manage Tasks

# Show details
firetasks show <uuid>

# Mark as done
firetasks done <uuid>

# Mark as in progress
firetasks progress <uuid>

# Update
firetasks update <uuid> --title "New title" --priority critical

# Delete
firetasks delete <uuid>

Projects

# Add project
firetasks add-project "FireTasks" \
  --description "Task management CLI" \
  --color "#FF5733"

# List projects
firetasks list-projects

Statistics

firetasks stats

TUI Interface

firetasks tui

The TUI interface offers an interactive terminal experience with:

• Navigation: ↑/↓ or j/k to navigate between tasks
• Quick actions:
  • d - Mark task as done
  • x - Delete task
  • a - Add new task
  • Enter - View task details
• Projects: p to manage projects
• Filters: f to filter by status, c to clear filters
• Quit: q to quit

Structure

firetasks/
├── src/
│   ├── main.rs        # CLI entry point
│   ├── core/          # Core library
│   │   ├── error.rs   # Error types
│   │   ├── task.rs    # Task model
│   │   ├── project.rs # Project model
│   │   ├── store.rs   # Persistence
│   │   └── mod.rs     # Public exports
│   └── tui/           # TUI interface
│       ├── app.rs     # TUI application logic
│       ├── ui.rs      # Interface rendering
│       └── mod.rs     # Public exports

Storage

Tasks are saved in ~/.firetasks/tasks.json in JSON format.

License

MIT