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のサポート

アーキテクチャ

5つのパッケージを含むUVワークスペースモノレポ：

ドキュメント

• クイックスタートガイド - ステップバイステップのセットアップ

• CLIコマンドリファレンス - 完全なコマンドドキュメント

• APIリファレンス - REST APIエンドポイントと例

• 設定ガイド - すべての設定オプション

• 設計思想 - Taskdogがこのように動作する理由

• デプロイガイド - Docker, systemd, launchd

貢献

貢献を歓迎します！ガイドラインについては CONTRIBUTING.md を参照してください。

ライセンス

MITライセンス - 詳細は LICENSE を参照してください。