Felicity Todos

A powerful, feature-rich command-line todo application with a beautiful interface and comprehensive task management capabilities.

Features

• 🎨 Color-coded Priority System

  • Low (Blue)
  • Medium (Yellow)
  • High (Orange)
  • Critical (Red)

• 📝 Task Management

  • Add, edit, and remove tasks
  • Set priorities and due dates
  • Mark tasks as complete/incomplete
  • Add notes to tasks
  • Search functionality

• 📂 Category System

  • Create and manage categories
  • Assign tasks to categories
  • Filter by category

• 📊 Multiple View Options

  • Default colored line view
  • Detailed table view
  • Statistics and overview

• 🔄 Data Management

  • Export/Import to CSV
  • SQLite database backend
  • Automatic backup support

Installation

pip install felicity-todos

Quick Start

1. Initialize the database:

t init

2. Add your first task:

t a -m "Complete project proposal" -p 3 -d "2024-03-20"

3. View your tasks:

t l

Usage

Basic Commands

Command	Description	Example
t init	Initialize database	t init
t a -m <message>	Add a todo	t a -m "Buy groceries"
t a -m <message> -p <priority>	Add with priority (0-3)	t a -m "Fix bug" -p 3
t a -m <message> -c <category>	Add with category	t a -m "Call John" -c "Personal"
t a -m <message> -d <date>	Add with due date	t a -m "Report" -d "2024-03-25"
t l	List all todos	t l
t e <id> <message>	Edit todo message	t e 5 "Updated task"
t rm <id>	Remove a todo	t rm 3

View Options

Default View

The default view displays tasks in a colored line format, where the entire line is colored according to the task's priority:

t l

Output example:

#1 Work Complete project proposal 2024-03-20 ✓
#2 Personal Buy groceries
#3 Work Fix critical bug 2024-03-18

Table View

For a more detailed view, use the table format:

t l -t

This displays tasks in a table with columns for ID, Message, Priority, Category, Due Date, and Status.

Category Management

Command	Description	Example
t ac <name>	Add a category	t ac "Work"
t ec <id> <name>	Edit category name	t ec 2 "Personal"
t lc	List all categories	t lc
t rmc <id>	Remove a category	t rmc 3

Filtering & Searching

Command	Description	Example
t l -p <priority>	List by priority	t l -p 2
t l -c <category>	List by category	t l -c "Work"
t l -p <priority> -c <category>	Filter by both	t l -p 3 -c "Work"
t l --done	Show completed	t l --done
t l --undone	Show incomplete	t l --undone
t l -d	Sort by due date	t l -d
t l --overdue	Show overdue	t l --overdue
t l -t	Display in table format	t l -t
t search <keyword>	Search todos	t search "meeting"

Task Status

Command	Description	Example
t done <id>	Mark as completed	t done 5
t undo <id>	Mark as not completed	t undo 5

Notes

Command	Description	Example
t n <id> <content>	Add note to todo	t n 4 "Remember to add examples"
t ln <id>	List notes for todo	t ln 4

Utilities

Command	Description	Example
t stats	Show statistics	t stats
t export <filename>	Export todos to CSV	t export ~/todos.csv
t import <filename>	Import todos from CSV	t import ~/todos.csv

Priority Levels

• 0: Low (Blue)
• 1: Medium (Yellow)
• 2: High (Orange)
• 3: Critical (Red)

Examples

Adding a Task with All Options

t a -m "Complete project proposal" -p 3 -c "Work" -d "2024-03-20"

Filtering Tasks

# Show all high-priority work tasks
t l -p 2 -c "Work"

# Show overdue tasks in table format
t l --overdue -t

# Show completed personal tasks
t l -c "Personal" --done

Managing Categories

# Create a new category
t ac "Projects"

# List tasks in a specific category
t l -c "Projects"

# Edit category name
t ec 1 "Active Projects"

Adding Notes

# Add a note to task #5
t n 5 "Don't forget to include the appendix"

# View notes for task #5
t ln 5

Tips

1. Organization: Use categories to group related tasks
2. Priorities: Set appropriate priorities to manage task importance
3. Due Dates: Always set due dates for time-sensitive tasks
4. Notes: Use notes for additional details and context
5. Regular Updates: Use t stats to get an overview of your tasks
6. Backup: Regularly export your tasks using t export

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.