CLI 안내

lifebase를 실행하면 터미널 마법사가 열립니다. 직접 명령은 작업 한 번을 수행하고 종료합니다. 각 명령에 --help를 붙이면 사용할 수 있는 옵션을 확인할 수 있습니다.

주요 명령

목적	명령
계정 로그인 후 라이선스 선택	lifebase login
브라우저를 열지 않고 인증 코드 표시	lifebase login --no-browser
마법사 열기	lifebase
라이선스와 연결된 vault 확인	lifebase status
현재 조건에서 이용 가능한 릴리스 확인	lifebase releases
지원 종료된 릴리스도 포함	lifebase releases --include-legacy
라이선스 인증	lifebase activate
연결된 vault 업데이트	lifebase update
진행 중인 업데이트 검토	lifebase update review
CLI 버전 확인	lifebase --version
vault 파일을 유지하며 로그아웃	lifebase logout

릴리스 목록은 라이선스, 콘텐츠 언어, CLI 호환성과 지원 상태에 따라 걸러집니다. 버전을 지정하지 않으면 설치나 업데이트는 조건에 맞는 최신 릴리스를 선택합니다. 업데이트 메뉴는 설치본보다 새로운 버전만 제공합니다.

기존 vault 연결

다른 기기에서 복사했거나 폴더를 옮겼다면 현재 절대 경로를 연결하세요.

lifebase link --vault /absolute/path/to/lifebase

연결은 설치본 버전 메타데이터를 확인하고 경로를 기억합니다. 파일 재설치, 에이전트 설정 변경이나 라이선스 서비스 접속은 하지 않으며 인증도 필요하지 않습니다. CLI는 로컬 설정마다 vault 경로 하나를 기억합니다.

업데이트 시 특정 vault를 지정하려면 해당 명령의 --vault 옵션을 사용합니다. 어떤 폴더가 연결되었는지 확실하지 않다면 파일을 바꾸기 전에 lifebase status로 확인하세요.

CLI만 별도로 업데이트

npm으로 설치했다면 다음 명령을 사용합니다.

npm install -g @lifebase/cli@latest

완료 후 lifebase를 새로 실행하세요. 이 명령은 터미널 도구를 업데이트하며 vault 콘텐츠는 바꾸지 않습니다. 다른 패키지 관리자로 설치했다면 같은 도구로 업데이트하세요. vault 업데이트는 Lifebase 업데이트를 참고하세요.

프로그램에서 읽는 출력

자동화나 스크립트에서는 아래처럼 하위 명령에 두 옵션을 함께 붙이세요.

lifebase status --json --non-interactive
lifebase releases --json --non-interactive
lifebase update review --unresolved-only --json --non-interactive

결과는 stdout, JSON 오류는 stderr로 출력하며 터미널 장식을 섞지 않습니다. 하위 명령 없는 lifebase에 자동화 옵션을 붙여도 마법사는 열리지 않습니다. 종료 코드가 0이어도 업데이트 검토가 남아 있을 수 있으므로 상태와 다음 작업을 읽어야 합니다.

lifebase update는 비대화형 실행에서도 변경을 적용할 수 있습니다. 이용 가능한 버전만 확인하려면 상태나 릴리스 조회 명령을 사용하세요. 라이선스 키는 명령 인수, 로그나 모델 프롬프트에 넣지 않습니다. 대화형 인증에는 숨김 입력이 제공됩니다.

계정 로그인에는 대화형 터미널과 브라우저 승인이 필요합니다. login --json --non-interactive는 인증을 시작하지 않고 input_required를 반환합니다. 자동화에서는 기존 라이선스 키 activate를 사용하세요.