Taskdog

Система управления задачами с интерфейсами CLI/TUI и REST API сервером, включающая отслеживание времени, оптимизацию расписания и красивый вывод в терминале.

Разработана для индивидуального использования. Хранит задачи локально в базе данных SQLite.

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

TUI (Textual)

Диаграмма Ганта (CLI)

Попробуйте

Попробуйте taskdog с ~50 примерами задач. Установка не требуется — достаточно 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: Поддержка Claude Desktop через протокол Model Context Protocol

Архитектура

Монорепозиторий UV workspace с пятью пакетами:

Документация

• Руководство по быстрому старту - Пошаговая настройка

• Справочник команд CLI - Полная документация по командам

• Справочник API - Конечные точки REST API и примеры

• Руководство по конфигурации - Все параметры конфигурации

• Философия дизайна - Почему Taskdog работает именно так

• Руководство по развертыванию - Docker, systemd, launchd

Участие в разработке

Вклад приветствуется! См. CONTRIBUTING.md для ознакомления с правилами.

Лицензия

Лицензия MIT — подробности см. в файле LICENSE.