시작하기

dillie CLI 를 설치하고 로그인해, 내 워크스페이스의 프로젝트를 처음 조회하기까지를 따라간다.

사전 요구사항

터미널에서 설치 스크립트를 실행한다.

curl -fsSL https://dillie.work/download/cli/install.sh | sh

스크립트는 운영체제와 CPU 에 맞는 실행 파일을 내려받아 체크섬을 확인한 뒤 ~/.local/bin/dillie 에 둔다. 체크섬이 맞지 않으면 설치하지 않고 멈춘다. 그 디렉터리가 PATH 에 없으면 쓰는 셸에 맞는 추가 방법을 출력하니 그대로 실행한다.

설치 위치나 버전을 바꾸려면 환경변수를 함께 준다.

환경변수	기본값	설명
`DILLIE_INSTALL_DIR`	`~/.local/bin`	실행 파일을 둘 디렉터리
`DILLIE_VERSION`	`latest`	설치할 릴리스 태그(예: `v0.20.0`)

Node.js 22.12 이상이 있으면 npm 으로 설치해도 된다.

npm install -g @gravity8/dillie-cli

설치가 끝났는지 확인한다.

dillie --version

dillie login

브라우저에 dillie 승인 화면이 열린다. 들어갈 워크스페이스를 고르고 승인하면 CLI 가 세션을 저장하고 Signed in 을 출력한다.

브라우저를 열 수 없는 환경(SSH 접속, CI)에서는 --device 를 붙인다. 화면에 나온 주소를 다른 기기의 브라우저에서 열고 코드를 입력한다.

dillie login --device

누구로 로그인됐는지 확인한다.

dillie whoami

이름·이메일·워크스페이스가 나오면 로그인된 것이다.

CLI 는 한 번에 한 워크스페이스에서 동작한다. 여러 워크스페이스에 속해 있으면 목록에서 지금 선택된 것이 current: true 로 표시된다.

dillie workspace list

다른 워크스페이스로 바꾸려면 그 워크스페이스의 tenantId 로 전환한다. 그 워크스페이스에서 dillie CLI 를 처음 쓰면 승인 화면이 다시 열린다.

dillie workspace use <tenantId>

dillie project projects list

목록은 기본으로 첫 페이지(50개)만 보여 준다. 다음 페이지가 있으면 표 아래에 more pages 가 붙는다(JSON 출력이면 page.hasMore 가 true 다). 전부 읽으려면 --paginate 를 붙인다(CLI 0.21.0 이상).

dillie project projects list --paginate

새 버전이 나오면 명령을 실행할 때 안내가 나온다. 설치 스크립트로 설치했으면 CLI 가 스스로 바꾼다.

dillie upgrade

npm 으로 설치했으면 npm 으로 다시 설치한다.

npm install -g @gravity8/dillie-cli@latest