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
uvxcomes 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.
