Taskdog

一个带有 CLI/TUI 界面和 REST API 服务器的任务管理系统，具备时间跟踪、日程优化和精美的终端输出功能。

专为个人使用而设计。任务存储在本地的 SQLite 数据库中。

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

TUI (Textual)

甘特图 (CLI)

试用

使用约 50 个示例任务来试用 taskdog。无需安装，只需 Docker：

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

TUI 可以在容器内运行，但某些快捷键（例如 Ctrl+P 用于命令面板）可能会与 Docker 的按键序列冲突。为了获得最佳体验，请在容器中运行服务器并从主机连接：

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 随 uv 提供。它在临时环境中运行命令，无需安装任何内容。

Related MCP server: mcp-task-manager

安装

要求：Python 3.12+，uv

支持的平台：Linux, macOS

推荐方式（使用 systemd/launchd 服务）

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

这将安装 CLI/TUI 和服务器，并设置 systemd (Linux) 或 launchd (macOS) 服务，以便服务器自动启动。

从 PyPI 安装

pip install taskdog-ui[server]

你需要自行管理服务器进程（例如 taskdog-server &）。

使用方法

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

有关包括 API 密钥配置在内的完整设置，请参阅 快速入门指南。

功能

• 多种界面：CLI、全屏 TUI 和 REST API

• 日程优化：9 种算法（贪心、遗传、蒙特卡洛等）

• 时间跟踪：自动跟踪，并进行计划与实际情况的对比

• 甘特图：带有工作负载分析的可视化时间轴

• 任务依赖：支持循环依赖检测

• Markdown 笔记：集成编辑器，支持 Rich 渲染

• 审计日志：跟踪所有任务操作

• MCP 集成：通过模型上下文协议 (Model Context Protocol) 支持 Claude Desktop

架构

包含五个包的 UV 工作区 monorepo：

文档

• 快速入门指南 - 分步设置

• CLI 命令参考 - 完整的命令文档

• API 参考 - REST API 端点和示例

• 配置指南 - 所有配置选项

• 设计理念 - 为什么 Taskdog 要这样设计

• 部署指南 - Docker, systemd, launchd

贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解指南。

许可证

MIT 许可证 - 详情请参阅 LICENSE。