TaskFlow

A project and task management system with CLI and API interfaces.

Features

• Project management with status tracking
• Task management with priorities, labels, and assignees
• Subtask support with completion tracking
• Sprint planning with velocity tracking
• Milestone tracking with progress monitoring
• Time tracking with timer support
• Task dependencies with critical path analysis
• Kanban board state management
• Team workload balancing
• Recurring task generation from templates
• Activity feed and audit logging
• CSV and JSON import/export
• Markdown report generation
• REST API (FastAPI)
• CLI interface (Click)

Quick Start

Installation

pip install -r requirements.txt

Initialize Database

taskflow init

Start the API Server

taskflow serve --reload

API documentation will be available at http://localhost:8000/api/v1/docs

Seed Sample Data

python scripts/seed_data.py

CLI Usage

taskflow projects list
taskflow projects create --name "My Project" --key "MP"
taskflow tasks list --project-id 1
taskflow tasks create --project-id 1 --title "First task"
taskflow tasks move 1 in_progress
taskflow sprints list --project-id 1
taskflow reports project 1
taskflow io export-csv 1 -o tasks.csv

Docker

docker build -t taskflow .
docker run -p 8000:8000 taskflow

Running Tests

pip install -r requirements-dev.txt
pytest tests/ -v

Project Structure

taskflow/
  app/
    models/       SQLAlchemy models
    schemas/      Pydantic schemas
    services/     Business logic
    routes/       FastAPI endpoints
    cli/          Click commands
    config.py     Settings
    database.py   DB connection
    main.py       FastAPI app
  tests/          Test suite
  migrations/     Alembic migrations
  scripts/        Utility scripts

API Endpoints

Resource	Methods
/projects	GET, POST, PUT, DELETE
/tasks	GET, POST, PUT, PATCH, DELETE
/subtasks	GET, POST, PUT, DELETE
/labels	GET, POST, PUT, DELETE
/milestones	GET, POST, PUT, DELETE
/time-entries	GET, POST, PUT, DELETE
/sprints	GET, POST, PUT, DELETE
/dependencies	GET, POST, PUT, DELETE
/templates	GET, POST, PUT, DELETE
/recurring	GET, POST, PUT, DELETE
/activity	GET
/search	GET
/kanban	GET, POST, PUT
/workload	GET
/reports	GET
/import-export	GET, POST

License

MIT