← CLI & REST API

명령줄 인터페이스 (CLI)

Willet CLI는 MCP 도구와 동일한 기능을 제공하며, 어떤 셸에서도 스크립트로 실행할 수 있습니다.

설치

CLI는 npm에 게시되어 있으며 Node.js 20 이상이 필요합니다.

npm install -g @willet/cli

설치된 바이너리는 willet. 기본적으로 Willet Cloud와 통신합니다: https://willet.bgenc.dev.

로그인 (Willet Cloud)

대화형으로 사용하려면 브라우저를 통해 로그인하세요. 기기 인증 페이지가 열리고, 단기 토큰이 ~/.willet/ 에 저장됩니다.

willet login

승인되면 활성 ID를 확인하세요:

willet whoami

다음 명령으로 저장된 자격 증명을 삭제하세요 willet logout.

API 시크릿 사용 (스크립트, CI, 자체 호스팅)

자동화 용도라면 브라우저 로그인을 건너뛰고 시크릿을 제공하세요 WILLET_API_TOKEN.

export WILLET_API_TOKEN=... willet whoami
  • 범위는 user(접근 가능한 모든 프로젝트) 또는 project(단일 프로젝트) 중 하나입니다.
  • 접근 수준은 read(읽기 전용) 또는 read_write(전체 접근) 중 하나입니다.
  • WILLET_API_TOKEN은 저장된 로그인보다 우선하며, 디스크에 기록되지 않습니다.

자체 호스팅 서버를 대상으로 지정

CLI가 자체 Willet 서버를 가리키도록 하는 세 가지 방법이 있습니다 (우선순위 높은 것부터):

  • --api-url <url> 모든 명령의 전역 플래그
  • WILLET_API_URL 환경 변수
  • apiUrl 설정 파일의 apiUrl 필드 ~/.willet/config.json

자체 호스팅 서버는 Willet 로그인을 지원하지 않습니다. 서버 설정 파일의 사용자 시크릿을 WILLET_API_TOKEN에 설정하여 인증하세요.

출력 및 스크립팅

  • --json 사람이 읽기 좋은 요약 대신 원시 JSON을 출력합니다. jq 같은 도구에 파이프하세요.
  • -p <projectId> 대부분의 작업 명령어에는 프로젝트 UUID가 필요합니다.
  • tags 플래그는 쉼표가 아닌 공백으로 구분합니다: --tags backend perf
willet --json ticket create "Set up CI" -p $PROJECT --type chore --tags ci infra

명령어 참조

명령어는 리소스별로 그룹화되어 있습니다. 각 그룹에는 고유한 하위 명령어가 있습니다:

그룹하위 명령어
willet ticketlist, search, get, create, update, delete, start, complete, cancel, reopen, comment, link, unlink, graph, tags
willet projectlist, create, delete, restore, set-key-prefix, stats, members
willet orglist, create, update, delete, members
willet githublist, link, unlink
willet renderboard, dependency-graph

특정 명령어의 정확한 플래그를 확인하려면 willet <group> --help.

종료 코드

스크립트는 프로세스 종료 코드에 따라 분기할 수 있습니다:

0성공
1일반 오류 또는 네트워크 오류
2인증 실패 (401)
3금지됨 (403), 예: 쓰기 작업에 읽기 전용 시크릿 사용
4찾을 수 없음 (404)

다음

CLI가 하는 모든 작업은 REST API를 통해 이루어집니다. 쉘을 사용하고 싶지 않을 때는 API를 직접 사용하세요.

REST API 레퍼런스 →