설치 & 인증

설치

npm 으로 전역 설치하면 alex 명령이 생깁니다.

npm i -g @twentyoz/alex-cli
alex --help

발행본은 Alexandria 운영 API 를 바라보도록 빌드되어 있습니다. 현재 연결 대상은 alex --help 상단에 표시됩니다.

인증

로그인은 브라우저 위임만 지원합니다 — captcha·Google·이메일/비밀번호 모두 브라우저에서 처리됩니다. CLI 가 비밀번호를 인자/환경변수로 직접 받지 않는 이유는 argv·ps 노출과 captcha 우회를 막기 위함입니다. 성공하면 토큰이 ~/.config/alex/ 에 저장되고 만료 시 자동 갱신됩니다.

# 대화형 — 브라우저가 자동으로 열리고 loopback 으로 토큰을 받습니다
alex auth login
alex auth whoami

# SSH/헤드리스 — 브라우저를 띄울 수 없으면 코드 붙여넣기로 자동 전환 (강제: --code)
alex auth login --code

# 같은 머신에서 URL 을 직접 열고 싶을 때 (자동 실행만 끔)
alex auth login --no-browser

CI/에이전트처럼 비대화형 환경에서는 발급된 access 토큰을 직접 주입합니다 (refresh 없음).

ALEX_TOKEN=<access_jwt> alex auth whoami