ai-todo
코딩 에이전트를 위한 AI 네이티브 태스크 관리 시스템
Cursor, Claude, Copilot과 같은 AI 에이전트와 자연스럽게 작동하는 간단하고 영구적이며 버전 제어되는 TODO 추적 기능입니다.
빠른 시작 (Quick Start)
프로젝트의 .cursor/mcp.json에 다음을 추가하세요:
{
"mcpServers": {
"ai-todo": {
...
그런 다음 Cursor Settings → MCP Servers에서 ai-todo를 켜세요.
설정이 끝입니다! 이제 AI 에이전트가 직접 태스크를 관리할 수 있습니다. 별도의 설치가 필요 없습니다.
사용해 보세요: 에이전트에게 "사용자 인증 구현을 위한 태스크를 생성해 줘"라고 요청하세요.
왜 ai-todo인가요? (Why ai-todo?)
AI 에이전트는 내부적으로 태스크를 추적하지만, 이는 세션이 끝나면 사라지는 폐쇄적인 시스템을 만듭니다. ai-todo는 Git 리포지토리 내에 영구적이고 버전 제어되는 기록을 제공합니다.
- 지속성 (Persistent) — 세션, 재시작, 시간 경과에도 태스크가 유지됩니다.
- 버전 제어 (Version Controlled) — 코드와 함께 Git에서 추적됩니다.
- AI 네이티브 (AI-Native) — 직접적인 에이전트 상호 작용을 위한 MCP 통합
- 인간 가독성 (Human Readable) — 표준 TODO.md 형식의 일반 Markdown
- 설정 불필요 (Zero Config) — 즉시 작동하며, 설정이 필요 없습니다.
- 즉각적 & 로컬 (Instant & Local) — API 호출, 인증 또는 속도 제한이 없습니다.
설치 옵션 (Installation Options)
옵션 A: 제로 설치 MCP (Zero-Install MCP) (권장)
Cursor 또는 유사한 IDE를 통한 AI 에이전트 통합용입니다. 영구적인 설치 없이 온디맨드(on-demand)로 실행하기 위해 uvx를 사용합니다.
프로젝트별 설정 (.cursor/mcp.json):
{
"mcpServers": {
"ai-todo": {
...
uv가 설치되어 있어야 합니다 (curl -LsSf https://astral.sh/uv/install.sh | sh).
옵션 B: 시스템 설치 (System Installation)
CLI 사용 또는 영구 MCP 서버 설정을 위한 것입니다. Python 3.10 이상이 필요합니다.
uv tool install ai-todo
...
CLI 사용: ai-todo [명령어] (예: `ai-todo add
- "사용자 인증(user authentication)을 구현하기 위한 작업 생성"
- "인증 기능(auth feature)을 하위 작업으로 분해"
- "작업 1 완료로 표시"
- "#bug 태그가 지정된 모든 작업 보여주기"
- "완료된 작업 보관(archive)"
- "30일보다 오래된 보관된 작업 정리하기" — TODO.md를 깔끔하게 유지
- "작업에서 #123의 문제 수정" — 작업에 GitHub Issues 참조
당신의 에이전트가 기술적인 세부 사항을 처리합니다. 모든 작업은 당신의 리포지토리 내 TODO.md에 저장됩니다.
실제로 사용해 보기 (See It In Action)
이 리포지토리는 자체 개발에 ai-todo를 사용합니다! 다음 TODO.md를 확인하여 다음을 살펴보세요:
- 하위 작업을 포함한 작업 계층 구조
- 태그 기반 구성 (
#feature, #bug, #documentation)
- 완료 추적 및 보관
- 실제 개발 워크플로우 작동 모습
문서 (Documentation)
라이선스 (License)
Apache License 2.0 — LICENSE 참고