Lifebase 설치

새로 설치할 때는 공식 CLI를 사용하세요. Lifebase 파일이 이미 있다면 다시 설치하지 않고 기존 vault 연결을 진행합니다.

실행 환경 확인

터미널에서 Node.js가 20 이상인지, npm을 사용할 수 있는지 확인합니다.

node --version
npm --version

Node.js나 Obsidian이 없다면 먼저 설치하세요. CLI 자체에는 Python이나 컴파일러가 필요하지 않습니다. 개별 에이전트 작업에는 추가 도구가 필요할 수 있으며, 온보딩에서 선택한 작업에 필요한 환경을 확인합니다.

Linux 인증에는 secret-tool과 잠금 해제된 Secret Service 호환 키링이 필요합니다. macOS에서는 Keychain, Windows에서는 현재 사용자 범위의 DPAPI 보호를 사용합니다.

설치 마법사 실행

npm install -g @lifebase/cli
lifebase

마법사는 다음 순서로 안내합니다.

Sign in에서 Lifebase account를 선택하면 브라우저에서 Google·GitHub 로그인을 승인하고 연결된 라이선스를 고를 수 있습니다. License key를 선택하면 숨김 프롬프트에 키를 입력합니다. AI 대화에 키를 붙여 넣지 마세요.
새 폴더 또는 비어 있고 쓰기 가능한 설치 폴더를 선택합니다. 권장 위치는 Documents 아래의 lifebase 폴더입니다.
콘텐츠 언어와 이용 가능한 Lifebase 버전을 선택합니다.
라이선스 약관을 읽고 동의합니다.
CLI가 릴리스를 다운로드하고 검증한 뒤, 연결할 AI 에이전트를 선택합니다.

방향키로 이동하고 Enter로 선택합니다. Esc는 하위 화면에서 돌아갑니다. Agent setup은 이미 설치된 AI 도구에 vault를 연결합니다. 에이전트 설치와 모델 제공자 로그인은 별도로 진행하세요.

한국어 콘텐츠를 직접 설치하기

언어를 선택할 때는 마법사가 가장 간단합니다. macOS나 Linux에서는 다음과 같이 직접 설치할 수도 있습니다.

lifebase install --path ~/Documents/lifebase --locale ko

Windows에서는 실제 절대 경로를 지정하세요.

lifebase install --path "C:\Users\YourName\Documents\lifebase" --locale ko

YourName은 자신의 Windows 사용자 폴더명으로 바꿉니다. 직접 설치 명령에서 --locale을 생략하면 한국어가 기본값입니다. 영어를 설치하려면 --locale en을 사용하며, 해당 언어의 릴리스가 제공되고 있어야 합니다. lifebase releases로 이용 가능 여부를 확인할 수 있습니다.

설치된 폴더 열기

Obsidian의 Open folder as vault에서 설치된 lifebase 폴더를 선택하세요. 요청이 표시되면 포함된 커뮤니티 플러그인을 활성화합니다. 숨김 설정과 버전 메타데이터를 포함해 폴더 전체를 함께 유지하세요.

에이전트에서도 같은 폴더를 작업 프로젝트로 열고 첫 세션으로 이어갑니다. 설치가 실패하면 오류 문구를 보관하고 문제 해결을 확인하세요. 문제를 해결하려고 개인 노트 위에 다시 설치하지 마세요.