Terminal Task Tracker

🚀 Terminal Task Tracker

A terminal-based task tracking application that uses a three-pane layout to manage and plan project tasks.

🔍 Image

✨ Features

• Three-pane terminal interface:
  • Task list (top-left)
  • Task details (top-right)
  • Project plan (bottom, full width)
• Task management:
  • Create, view, edit, and delete tasks
  • Set priority and status
  • Add detailed descriptions
• Project plan management:
  • Define high-level project steps
  • Track step completion
  • Reorder steps
• Full API for programmatic access
• Command-line interface for scripting
• Data persistence

📦 Installation

# Clone the repository
git clone https://github.com/yourusername/terminal-task-tracker.git
cd terminal-task-tracker

# Install dependencies
pip install -e .

💻 Usage Examples

Terminal Interface

Launch the terminal interface:

python -m main.py

Keyboard bindings:

• Tab: Switch between windows
• Up/Down: Navigate lists
• Enter: Select a task (in the task list)
• n: Create a new item (in the task list or plan)
• e: Edit an item
• d: Delete an item
• Space: Toggle completion status (in the plan)
• Esc: Exit

Command-line Interface

The CLI provides access to all features:

# List all tasks
python -m app.api.cli task list

# Add a new task
python -m app.api.cli task add "Implement Feature X" --description "Detailed information about Feature X" --priority 2

# Mark a plan step as completed
python -m app.api.cli plan toggle STEP_ID

# Export data to JSON
python -m app.api.cli export data.json

API Usage

from app.core.task_manager import TaskManager
from app.core.plan_manager import PlanManager
from app.api.api import TaskTrackerAPI

# Initialize managers
task_manager = TaskManager("tasks.json")
plan_manager = PlanManager("plan.json")

# Create API
api = TaskTrackerAPI(task_manager, plan_manager)

# Add a task
task = api.add_task("Implement Feature X", "Detailed information about Feature X", priority=2)

# Add a plan step
step = api.add_plan_step("Design the architecture for the shared operation module")

# Mark the step as completed
api.toggle_plan_step(step["id"])

# Save data
api.save_all()

📚 Documentation

Project Structure

terminal-task-tracker/
├── app/
│   ├── __init__.py
│   ├── core/               # Business logic
│   │   ├── __init__.py
│   │   ├── task_manager.py
│   │   └── plan_manager.py
│   ├── ui/                 # Terminal UI
│   │   ├── __init__.py
│   │   ├── terminal_ui.py
│   │   ├── ui_components.py
│   │   └── input_handler.py
│   └── api/                # API and CLI
│       ├── __init__.py
│       ├── api.py
│       └── cli.py
├── main.py                 # Application entry point
└── README.md

Data Storage

By default, data is saved in the ~/.tasktracker directory:

• tasks.json: Task data
• plan.json: Project plan data
• notes.json: Note data

📄 License

MIT