Taskdog

A task management system with CLI/TUI interfaces and REST API server, featuring time tracking, schedule optimization, and beautiful terminal output.

Designed for individual use. Stores tasks locally in SQLite database.

https://github.com/user-attachments/assets/47022478-078d-4ad9-ba7d-d1cd4016e105

TUI (Textual)

Gantt Chart (CLI)

Try It Out

Try taskdog with ~50 sample tasks. No installation required — just Docker:

docker run --rm -it ghcr.io/kohei-wada/taskdog:demo

The TUI works inside the container, but some keybindings (e.g., Ctrl+P for command palette) may conflict with Docker's key sequences. For the best experience, run the server in a container and connect from your host:

docker run --rm -d -p 8000:8000 --name taskdog-demo ghcr.io/kohei-wada/taskdog:demo

# Wait for the server and demo data to be ready (~15s)
docker logs -f taskdog-demo 2>&1 | grep -m1 "Server ready"

uvx --from taskdog-ui taskdog tui

uvx comes with uv. It runs the command in a temporary environment without installing anything.

Installation

Requirements: Python 3.12+, uv

Supported Platforms: Linux, macOS

Recommended (with systemd/launchd service)

git clone https://github.com/Kohei-Wada/taskdog.git
cd taskdog
make install

This installs the CLI/TUI and server, and sets up a systemd (Linux) or launchd (macOS) service so the server starts automatically.

From PyPI

pip install taskdog-ui[server]

You'll need to manage the server process yourself (e.g., taskdog-server &).

Usage

taskdog add "My first task" --priority 10
taskdog table
taskdog gantt
taskdog tui

For complete setup including API key configuration, see Quick Start Guide.

Features

• Multiple Interfaces: CLI, full-screen TUI, and REST API
• Schedule Optimization: 9 algorithms (greedy, genetic, monte carlo, etc.)
• Time Tracking: Automatic tracking with planned vs actual comparison
• Gantt Chart: Visual timeline with workload analysis
• Task Dependencies: With circular dependency detection
• Markdown Notes: Editor integration with Rich rendering
• Audit Logging: Track all task operations
• MCP Integration: Claude Desktop support via Model Context Protocol

Architecture

UV workspace monorepo with five packages:

| Package | Description | PyPI | | ------- | ----------- | ---- | | taskdog-core | Core business logic and SQLite persistence | | | taskdog-client | HTTP API client library | | | taskdog-server | FastAPI REST API server | | | taskdog-ui | CLI and TUI interfaces | | | taskdog-mcp | MCP server for Claude Desktop | |

Documentation

• Quick Start Guide - Step-by-step setup
• CLI Commands Reference - Complete command documentation
• API Reference - REST API endpoints and examples
• Configuration Guide - All configuration options
• Design Philosophy - Why Taskdog works this way
• Deployment Guide - Docker, systemd, launchd

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.