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를 참조하세요.