@dodo-planet/cli

Dodo Planet 가족 여행 데이터에 터미널에서 접근하는 CLI.

설치

npm install -g @dodo-planet/cli

인증

1. https://www.dodoplanet.space 로그인 → 설정 → 개발자 토큰에서 PAT 발급
2. 평문 토큰을 한 번만 표시하므로 즉시 복사
3. CLI에 등록:

dodo auth login --token dodo_pat_<your_token>
# 또는 환경변수
export DODO_TOKEN=dodo_pat_<your_token>

자주 쓰는 명령

dodo trip list                        # 내 여행 목록
dodo trip switch "스페인 2026"         # 활성 trip 전환
dodo expense list                     # 활성 trip의 경비
dodo expense add --amount 30000 --currency KRW \
  --description "점심" --type shared
dodo flight search --from ICN --to BCN --date 2026-01-10
dodo chat "오늘 일정 알려줘"           # AI 챗 (single-shot)
dodo chat                             # AI 챗 (멀티턴 REPL)

출력 모드

dodo trip list --output json          # 스크립트용
dodo trip list                        # TTY면 표, 파이프면 JSON 자동
dodo config set output json           # 영구 기본값
NO_COLOR=1 dodo trip list             # 색상 끄기

자동완성

dodo completion bash >> ~/.bash_completion
dodo completion zsh > ~/.config/dodo/_dodo  # fpath 추가 또는
echo 'eval "$(dodo completion zsh)"' >> ~/.zshrc
dodo completion fish > ~/.config/fish/completions/dodo.fish

명령 트리 (21개 카테고리, 43개 함수 매핑)

• auth — login/logout/whoami/tokens
• config — get/set/path
• trip — list/current/switch/create
• expense — list/add/update/delete
• booking — list/add/update/delete
• itinerary — show/add/remove/reorder
• feed — list/post/delete
• baby — list/info/add/update/status/note/delete
• flight / hotel / activity / transfer — search
• place — search/search-text/details
• directions / weather / flight-status / web — single
• family / friend / invite
• chat — AI 자연어 (서버 SSE 프록시)
• raw <function_name> --data '{...}' — escape hatch

dodo <command> --help 로 자세한 인자 확인.

Exit code

| 코드 | 의미 | |------|------| | 0 | 정상 | | 1 | 일반 오류 | | 2 | 잘못된 인자 | | 3 | 네트워크/서버 오류 | | 4 | 인증 실패 | | 5 | 권한 없음 | | 6 | confirm 누락 (destructive 명령) |

환경변수

• DODO_TOKEN — PAT (credentials 파일 무시)
• DODO_API_URL — API 엔드포인트 (기본 https://www.dodoplanet.space)
• DODO_CONFIG_HOME — 설정 디렉토리 (기본 ~/.config/dodo)
• NO_COLOR / CI — 색상 비활성화