Taskdog

Un sistema de gestión de tareas con interfaces CLI/TUI y servidor de API REST, que incluye seguimiento del tiempo, optimización de cronogramas y una atractiva salida de terminal.

Diseñado para uso individual. Almacena las tareas localmente en una base de datos SQLite.

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

TUI (Textual)

Gráfico de Gantt (CLI)

Pruébalo

Prueba taskdog con unas 50 tareas de ejemplo. No requiere instalación, solo Docker:

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

La TUI funciona dentro del contenedor, pero algunos atajos de teclado (por ejemplo, Ctrl+P para la paleta de comandos) pueden entrar en conflicto con las secuencias de teclas de Docker. Para obtener la mejor experiencia, ejecuta el servidor en un contenedor y conéctate desde tu 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 viene con uv. Ejecuta el comando en un entorno temporal sin instalar nada.

Related MCP server: mcp-task-manager

Instalación

Requisitos: Python 3.12+, uv

Plataformas compatibles: Linux, macOS

Recomendado (con servicio systemd/launchd)

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

Esto instala la CLI/TUI y el servidor, y configura un servicio systemd (Linux) o launchd (macOS) para que el servidor se inicie automáticamente.

Desde PyPI

pip install taskdog-ui[server]

Tendrás que gestionar el proceso del servidor tú mismo (por ejemplo, taskdog-server &).

Uso

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

Para una configuración completa, incluida la configuración de la clave API, consulta la Guía de inicio rápido.

Características

• Múltiples interfaces: CLI, TUI de pantalla completa y API REST

• Optimización de cronogramas: 9 algoritmos (voraz, genético, monte carlo, etc.)

• Seguimiento del tiempo: Seguimiento automático con comparación entre lo planificado y lo real

• Gráfico de Gantt: Cronograma visual con análisis de carga de trabajo

• Dependencias de tareas: Con detección de dependencias circulares

• Notas en Markdown: Integración con el editor con renderizado Rich

• Registro de auditoría: Rastrea todas las operaciones de las tareas

• Integración MCP: Soporte para Claude Desktop a través del Protocolo de Contexto de Modelo

Arquitectura

Monorepo de espacio de trabajo UV con cinco paquetes:

Documentación

• Guía de inicio rápido - Configuración paso a paso

• Referencia de comandos CLI - Documentación completa de comandos

• Referencia de API - Endpoints y ejemplos de la API REST

• Guía de configuración - Todas las opciones de configuración

• Filosofía de diseño - Por qué Taskdog funciona de esta manera

• Guía de despliegue - Docker, systemd, launchd

Contribuciones

¡Las contribuciones son bienvenidas! Consulta CONTRIBUTING.md para conocer las directrices.

Licencia

Licencia MIT - consulta LICENSE para más detalles.