doque

멀티환경 통합 작업 관리 CLI. 프로젝트, 작업, 문서를 터미널에서 관리한다.

용어

| 용어 | 의미 | 비유 | |------|------|------| | Namespace | 사용자 또는 조직 단위의 작업 공간. 로그인하면 개인 namespace가 기본 설정된다. | GitHub의 @username 또는 organization | | Vessel | 프로젝트. namespace 안에 여러 vessel을 만들 수 있다. | GitHub의 repository | | Cargo | 작업 항목. vessel 안에 무한 뎁스로 중첩 가능하다. epic > story > task 계층 구조. | Jira의 이슈/티켓 | | Journal | cargo에 딸린 기록 문서. ADR, 세션 기록, 설계 문서 등을 작성한다. | 작업 노트/의사결정 기록 | | Comment | cargo에 딸린 짧은 댓글. | 이슈 댓글 | | Beacon | 등록된 디바이스. 로그인 시 자동 등록되어 어떤 기기에서 작업했는지 추적한다. | 접속 디바이스 |

Cargo 타입

| 타입 | 용도 | |------|------| | epic | 대규모 기능 단위 (여러 story를 포함) | | story | 사용자 관점의 기능 단위 | | task | 실제 수행할 작업 | | todo | 간단한 할 일 | | bug | 버그 수정 |

Cargo 상태

backlog → in_progress → review → done

Journal 타입

adr (의사결정) / session (세션 기록) / design (설계) / note (메모) / memo (일반) / review (리뷰) / test (테스트)

설치

npm install -g doque

빠른 시작

# 로그인 (브라우저가 열리고 인증 진행)
doque auth login

# 네임스페이스 확인
doque ns list

# 프로젝트 선택
doque vessel list
doque vessel use my-project

# 작업 관리
doque cargo list
doque cargo create --title "API 구현" --type task
doque cargo start 1
doque cargo done 1

# 작업 트리 (중첩 구조)
doque cargo tree

명령어

인증

auth login              Device Flow 또는 PAT(--token)으로 로그인
auth status             현재 인증 상태 확인
auth logout             로그아웃
whoami                  사용자 + 컨텍스트 + 디바이스 정보

네임스페이스

ns list                 내 네임스페이스 목록
ns use <slug>           네임스페이스 전환
ns info [slug]          네임스페이스 상세 정보

프로젝트 (Vessel)

vessel list             현재 네임스페이스의 프로젝트 목록
vessel use <slug>       프로젝트 선택
vessel create <slug>    프로젝트 생성
vessel info <slug>      프로젝트 상세 정보

작업 (Cargo)

cargo list              현재 프로젝트의 작업 목록
cargo tree              작업 트리 (중첩 구조)
cargo create            작업 생성 (--title, --type, --parent)
cargo info <id>         작업 상세 정보
cargo update <id>       작업 수정
cargo start <id>        작업 시작 (-> in_progress)
cargo done <id>         작업 완료 (-> done)
cargo status <id> <s>   상태 변경 (backlog/in_progress/review/done)
cargo delete <id>       작업 삭제

Cargo 타입: epic / story / task / todo / bug

기록 (Journal)

journal list <cargo-id>                   목록
journal create <cargo-id> --title "..."   생성 (--type adr/session/design/note/memo)
journal create <cargo-id> --stdin         stdin에서 내용 읽기
journal read <journal-id>                 내용 조회
journal update <journal-id> --content "." 수정
journal delete <journal-id>               삭제

댓글 (Comment)

comment list <cargo-id>                   댓글 목록
comment add <cargo-id> "내용"              댓글 추가

덤프 (벌크 조회)

dump tree                         Cargo 트리 (제목/상태만)
dump full                         Cargo + Journal 전체 내용
dump cargo <id> --deep            특정 Cargo + 하위 + Journal

--format json / --format markdown 지원.

활동/디바이스/설정

activity list             내 최근 활동
beacon list               내 등록 디바이스 목록
beacon delete <id>        디바이스 삭제
config list               전체 설정 조회
config set <key> <value>  설정값 변경
status                    현재 컨텍스트 확인

컨텍스트

CLI는 "현재 네임스페이스"와 "현재 프로젝트"를 기억한다.

doque ns use my-org          # 네임스페이스 전환
doque vessel use my-project  # 프로젝트 선택
doque status                 # 현재 컨텍스트 확인

# 이후 cargo/journal/comment 명령어는 선택된 프로젝트 기준으로 동작
doque cargo list             # my-org/my-project의 작업 목록

설정은 ~/.doque/config.json에 저장된다.

Claude Code 연동

AI 에이전트(Claude Code)가 프로젝트 컨텍스트를 로드하고 작업 문서화하는 데 사용한다.

초기 설정

cd ~/projects/my-project
doque init

.claude/skills/doque/SKILL.md가 생성되어 Claude Code가 doque 사용법을 자동 참조한다.

Claude Code 워크플로우

# 세션 시작 - 전체 구조 파악
doque status
doque dump tree

# 필요한 작업 상세 로드
doque dump cargo 1 --deep

# 작업 중 - 상태 변경 + 기록
doque cargo start 1
doque journal create 1 --title "SESSION-001" --type session --stdin

# 세션 종료 - 완료 기록
doque cargo done 1

출력 형식

doque cargo list --format json       # JSON (파싱용)
doque dump full --format markdown    # Markdown (컨텍스트용)

인증 방식

Device Flow (기본)

doque auth login
# 브라우저가 열리고 로그인 + 승인 진행

Personal Access Token (브라우저 없는 환경)

doque auth login --token
# 또는
DOQUE_TOKEN=xxx doque cargo list

토큰 우선순위: DOQUE_TOKEN 환경변수 > --token 플래그 > ~/.doque/config.json

서버 설정

기본값:

• API 서버: https://doque-api.rn00n.com
• 인증 서버: https://auth.rn00n.com

변경:

doque config set server http://localhost:8080
doque config set authServer http://localhost:8081