kanban

키보드 중심 인터페이스

hjkl 네비게이션, vim 스타일 검색(/), 점프 모션(gg/G), 반 페이지 스크롤({/}) 등 키보드 단축키로 모든 작업을 수행할 수 있습니다. 마우스에 손을 뻗을 필요 없이 완전한 키보드 플로우를 경험할 수 있으며, 100단계 실행 취소/다시 실행을 지원합니다.

세 가지 인터페이스

• TUI (터미널 UI): 대화형 작업을 위한 인터랙티브 인터페이스
• CLI: 스크립팅 가능한 커맨드 라인 인터페이스로 모든 작업을 JSON 출력과 함께 처리
• MCP 서버: Claude Code, Cursor 등과 같은 MCP 클라이언트와 통합되는 47개 도구

Git 네이티브 워크플로우

카드에서 ‘y’ 키를 눌러 Git 브랜치 이름을, ‘Y’ 키를 눌러 전체 git checkout 명령을 클립보드에 복사할 수 있습니다. 카드 접두사가 브랜치 이름에 매핑되어 자연스러운 개발 워크플로우를 제공합니다.

스프린트 계획

Planning → Active → Completed로 이어지는 전체 스프린트 라이프사이클을 관리할 수 있습니다. 미완료 카드를 한 키로 다음 스프린트로 가져가며, 스프린트별 카드 접두사 오버라이드와 할당 이력을 카드별로 추적합니다.

풍부한 카드 속성

우선순위(낮음/중간/높음/긴급), 상태(할당/진행중/차단됨/완료), 스토리 포인트, 마감일, 마크다운 설명, 상위/하위 종속성(순환 검출 포함), 대량 작업, 아카이브 및 복원 기능을 지원합니다.

로컬 우선 저장소

JSON(기본) 또는 SQLite를 저장소로 선택할 수 있으며, 파일 확장자에 따라 자동으로 선택됩니다. 원자적 쓰기, 실시간 파일 감시, 동시 쓰기 시 충돌 감지를 통해 데이터 무결성을 보장합니다. 클라우드나 계정이 필요 없습니다.

Cargo를 통한 설치

Rust가 설치되어 있다면 다음 명령어로 쉽게 설치할 수 있습니다:

cargo install kanban-cli

Homebrew (macOS/Linux)

brew install fulsomenko/tap/kanban

Nix

nix run nixpkgs#kanban

Arch Linux (AUR)

yay -S kanban

Chocolatey (Windows)

choco install kanban

소스에서 빌드

git clone https://github.com/kanban-rs/kanban

cd kanban

cargo install –path crates/kanban-cli

TUI 시작

다음 명령어로 TUI를 시작할 수 있습니다:

• kanban: 메모리에서 시작하며 시작 대화상자에서 파일을 선택하거나 건너뛸 수 있습니다
• kanban boards.json: JSON 보드 파일을 열거나 생성합니다
• kanban boards.sqlite: SQLite 보드 파일을 열거나 생성합니다

어디서든 ‘?’ 키를 누르면 현재 컨텍스트에 대한 도움말을 볼 수 있습니다.

CLI 사용법

환경 변수 KANBAN_FILE을 설정하거나 첫 번째 인수로 경로를 전달할 수 있습니다:

export KANBAN_FILE=boards.json

주요 CLI 명령어:

• kanban board create –name “My Project” –with-default-columns: TODO/Doing/Complete 컬럼이 포함된 보드 생성
• kanban board list: 보드 목록 표시
• kanban card create –board “My Project” –column TODO –title “Fix the bug” –priority high: 카드 생성
• kanban card list –board “My Project”: 카드 목록 표시
• kanban sprint create –board “My Project”: 스프린트 생성
• kanban sprint activate yarara-release –duration-days 14: 스프린트 활성화
• kanban relation add –parent KAN-5 –child KAN-7: 카드 간 관계 설정

모든 명령어는 JSON 형식으로 출력됩니다.

MCP 서버 설정

Claude Code에서 MCP 서버를 사용하려면 다음 JSON 설정을 추가합니다:

{“mcpServers”: {“kanban”: {“command”: “kanban-mcp”, “args”: [“boards.json”]}}}

이런 경우에 유용합니다

• 개발 팀이 스프린트 기반으로 프로젝트를 관리할 때
• 마우스 없이 키보드로만 업무를 관리하고 싶은 사용자
• Git 브랜치와 작업 카드를 연결하여 워크플로우를 자동화하고 싶은 개발자
• 로컬에서 프라이버시를 보장하며 프로젝트를 관리해야 하는 환경
• LLM과 연동하여 AI 기반 프로젝트 관리를 원하는 사용자
• 오프라인 환경에서도 작업을 지속해야 하는 경우

지원 환경·시스템 요구사항

• 지원 OS: Windows, macOS, Linux
• 빌드 요구사항: Rust 1.75 이상, Cargo
• 저장소 백엔드: JSON(기본) 또는 SQLite
• 편집기 설정: 외부 편집기를 위해 $EDITOR 환경 변수를 설정해야 합니다. Windows에서는 기본값으로 notepad를 사용합니다.
• 리눅스 클립보드 지원: Wayland에서는 wl-clip-persist, cliphist, clipman 등이 필요하며, X11에서는 대부분의 데스크톱 환경에 기본 포함되어 있습니다.

최신 버전·업데이트

현재 최신 버전은 0.9.0이며, 다음 기능이 추가되었습니다:

• 점진적 자동 저장
• TUI 작업과 동일한 전체 CLI 인터페이스
• 카드 종속성(상위/하위 및 차단)
• 실행 취소/다시 실행 지원
• LLM 통합을 위한 MCP 서버
• 다중 저장소 백엔드(JSON, SQLite)

제한 사항·확인 사항

• 편집기 호환성: VS Code는 현재 구현에서 작동하지 않습니다. Neovim, nano와 같은 터미널 기반 편집기를 권장합니다.
• 클립보드 지속성: 리눅스에서 키 ‘y’/’Y’를 사용한 클립보드 작업은 앱이 종료된 후에도 지속되려면 클립보드 매니저가 필요합니다.
• Windows + WSL 환경: Windows와 WSL을 자주 전환하는 경우, 각 시스템에 별도의 바이너리를 설치하는 것이 좋습니다.
• 데이터 형식: 카드 이름이나 ID가 일치하지 않으면 사용 가능한 옵션이 포함된 오류가 표시됩니다.