Taskdog

Ein Aufgabenverwaltungssystem mit CLI/TUI-Schnittstellen und REST-API-Server, das Zeiterfassung, Zeitplanoptimierung und eine ansprechende Terminal-Ausgabe bietet.

Entwickelt für die individuelle Nutzung. Speichert Aufgaben lokal in einer SQLite-Datenbank.

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

TUI (Textual)

Gantt-Diagramm (CLI)

Ausprobieren

Testen Sie taskdog mit ca. 50 Beispielaufgaben. Keine Installation erforderlich — einfach Docker:

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

Die TUI funktioniert innerhalb des Containers, aber einige Tastenkombinationen (z. B. Ctrl+P für die Befehlspalette) können mit den Tastensequenzen von Docker in Konflikt geraten. Für die beste Erfahrung führen Sie den Server in einem Container aus und verbinden Sie sich von Ihrem Host aus:

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 wird mit uv geliefert. Es führt den Befehl in einer temporären Umgebung aus, ohne etwas zu installieren.

Related MCP server: mcp-task-manager

Installation

Voraussetzungen: Python 3.12+, uv

Unterstützte Plattformen: Linux, macOS

Empfohlen (mit systemd/launchd-Dienst)

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

Dies installiert die CLI/TUI sowie den Server und richtet einen systemd- (Linux) oder launchd-Dienst (macOS) ein, damit der Server automatisch startet.

Über PyPI

pip install taskdog-ui[server]

Sie müssen den Serverprozess selbst verwalten (z. B. taskdog-server &).

Verwendung

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

Für die vollständige Einrichtung einschließlich der API-Schlüsselkonfiguration siehe Schnellstartanleitung.

Funktionen

• Mehrere Schnittstellen: CLI, Vollbild-TUI und REST-API

• Zeitplanoptimierung: 9 Algorithmen (Greedy, Genetisch, Monte Carlo, etc.)

• Zeiterfassung: Automatische Erfassung mit Vergleich von geplanten vs. tatsächlichen Zeiten

• Gantt-Diagramm: Visuelle Zeitachse mit Arbeitslastanalyse

• Aufgabenabhängigkeiten: Mit Erkennung zirkulärer Abhängigkeiten

• Markdown-Notizen: Editor-Integration mit Rich-Rendering

• Audit-Protokollierung: Verfolgen Sie alle Aufgabenoperationen

• MCP-Integration: Unterstützung für Claude Desktop über das Model Context Protocol

Architektur

UV-Workspace-Monorepo mit fünf Paketen:

Dokumentation

• Schnellstartanleitung - Schritt-für-Schritt-Einrichtung

• CLI-Befehlsreferenz - Vollständige Befehlsdokumentation

• API-Referenz - REST-API-Endpunkte und Beispiele

• Konfigurationshandbuch - Alle Konfigurationsoptionen

• Design-Philosophie - Warum Taskdog so funktioniert

• Bereitstellungshandbuch - Docker, systemd, launchd

Mitwirken

Beiträge sind willkommen! Siehe CONTRIBUTING.md für Richtlinien.

Lizenz

MIT-Lizenz - siehe LICENSE für Details.