taskmd
CI
codecov
마크다운 기반으로 설계되어 인간과 AI 코딩 어시스턴트 모두를 위한 작업 관리 시스템입니다.
taskmd가 제공하는 기능:
- 작업 파일의 표준화된 형식 — 작업이 YAML 프론트매터(frontmatter)가 포함된 읽기 쉬운
.md 파일로 저장되며, 코드와 함께 버전 관리가 됩니다.
- 관리용 CLI — 터미널에서 작업을 생성, 업데이트, 필터링, 검증 및 시각화합니다.
- 시각화를 위한 웹 대시보드 — 브라우저에서 칸반 보드(Kanban board), 의존성 그래프, 프로젝트 메트릭을 제공합니다.
- AI 스킬 세트 — AI 어시스턴트가 작업을 생성, 업데이트 및 처리할 수 있도록 슬래시 명령어를 제공합니다.
- 작업 관리 도구를 노출하는 MCP 서버 — Model Context Protocol을 통해 AI 어시스턴트에게 직접적인 도구 접근성을 제공합니다.
모든 것이 로컬에서 실행됩니다. 작업 데이터는 리포지토리에 유지되며 외부와 공유되지 않습니다.
빠른 시작
설치
Homebrew (macOS 및 Linux)
brew tap driangle/tap
brew install taskmd
taskmd --version
Docker (CLI 및 웹 대시보드, 별도 설치 불필요)
docker run --rm -p 8080:8080 -v ./tasks:/tasks:ro ghcr.io/driangle/taskmd
...
Go
go install github.com/driangle/taskmd/apps/cli/cmd/taskmd@latest
go install은 CLI만 빌드하며, 웹 대시보드는 Go 모듈의 일부가 아니기 때문에 포함되지 않습니다.
Linux, macOS 및 Windows용 사전 구축된 바이너리와 소스 코드 빌드 방법은 설치 페이지에서 확인할 수 있습니다.
30초 설정
-
프로젝트에 taskmd 초기화하기:
cd my-project
taskmd init
-
첫 번째 작업 만들기:
taskmd add "My first task" --priority high
-
작업 목록 보기:
-
웹 인터페이스 실행하기:
작업(Tasks)은 tasks/ 디렉터리 아래의 일반 마크다운 파일이므로, 편집기에서 생성하고 수정할 수도 있습니다. 튜토리얼에서는 의존성, 권장 사항 및 유효성 검사에 대해 자세히 설명합니다.
사용법 (Usage)
CLI 명령어 (CLI Commands)
웹 인터페이스 (Web Interface)
- Tasks: 정렬 및 필터링이 가능한 테이블
- Board: 상태(status), 우선순위(priority), 노력도(effort), 유형(type), 그룹(group), 태그(tag) 또는 단계(phase)별로 묶인 칸반 보드이며, 드래그 앤 드롭을 지원합니다.
- Graph: 상호작용하는 의존성 그래프
- Stats, Next, Tracks, Phases, Feed, Validate: 각각의 페이지를 제공합니다.
서버는 127.0.0.1에 바인딩되며 API는 인증이 필요하지 않습니다. --host 0.0.0.0으로 노출하기 전에 웹 가이드에서 네트워크 접근(Network Access)을 읽어보세요.
Claude Code 플러그인 (Claude Code Plugin)
슬래시 명령어(/)를 사용하여 Claude Code 내에서 taskmd를 직접 사용하세요:
/taskmd:next-task # 작업할 다음 작업을 찾습니다
/taskmd:do-task 015 # 작업을 선택하고 진행합니다
/taskmd:list-tasks --status pending # 보류 중인 작업 목록을 보여줍니다
...
세 가지 플러그인이 제공됩니다. taskmd는 CLI를 구동하는 슬래시 명령어 기능을 제공합니다. taskmd-mcp는 Claude가 도구(tools)로 task 작업을 호출할 수 있도록 MCP 서버를 제공하며, taskmd와 함께 설치될 수 있습니다. taskmd-lite는 바이너리 설치가 불가능한 환경에서 Claude의 파일 도구를 사용하여 해당 기능을 재구현합니다. 어떤 것을 선택해야 하는지는 플러그인 가이드를 참고하세요.
claude plugin marketplace add driangle/taskmd
...
전체 세부 정보는 [claude-code-plugin/README.md]를 참조하세요.
문서화 (Documentation)
전체 문서를 읽기 →
작업은 YAML 프론트매터(frontmatter)가 포함된 마크다운 파일입니다:
---
id: "001"
title: "Implement feature X"
...
전체 형식 세부 정보는 작업 사양 (Task Specification)를 참조하세요.
설정 (Configuration)
taskmd는 기본 옵션을 설정하기 위해 .taskmd.yaml 설정 파일을 지원합니다:
taskmd는 하나의 설정 파일을 로드합니다: 현재 디렉토리에서 리포지토리 루트까지 올라가면서 발견되는 가장 가까운 .taskmd.yaml, 또는 그렇지 않으면 ~/.taskmd.yaml입니다. 이 두 파일은 병합되지 않으므로, 프로젝트 파일이 있으면 홈 파일은 무시됩니다. 명령줄 플래그와 TASKMD_* 환경 변수는 파일의 내용을 덮어씁니다.
지원되는 모든 옵션을 포함한 전체 예시는 [docs/.taskmd.yaml.example]를 참조하세요.
작업 레이아웃 (Task Layout)
my-project/
├── tasks/ # 작업 파일
│ ├── 001-task.md
...
기여 (Contributing)
- CONTRIBUTING.md: 코어에 포함되어야 할 내용, taskmd 확장 방법, 그리고 PR(Pull Request) 프로세스
- AGENTS.md: 로컬 설정, 빌드 및 테스트 명령어, 린트 규칙(lint rules), 그리고 버전 관리 (versioning). (
CLAUDE.md는 이 파일의 심볼릭 링크입니다.)
- Task Specification: 태스크 형식 규칙(task format conventions)
cd apps/cli
make build
make check
라이선스 (License)
MIT 라이선스 - 자세한 내용은 LICENSE를 참조하세요.
지원 (Support)