설치

Source: cli/install.md · Live: https://docs.1pass.dev/cli/install LLM-sanitized: internal links absolutized, VitePress containers → admonitions, line numbers in the Jump-to Index reference this rendered file (1-indexed).

📍 Jump-to Index

• L17-L39: ## Homebrew (권장)
• L40-L50: ## RubyGems (대안)
• L51-L77: ## 직접 빌드 (선택)
• L78-L81: ## 다음

---

설치

Homebrew (권장)

brew install dcode-co/logi/logi

최초 실행 시 tap 저장소(github.com/dcode-co/homebrew-logi)가 자동으로 등록됩니다. 이후에는 brew upgrade logi(업그레이드), brew uninstall logi(제거)처럼 짧은 이름으로 관리하면 됩니다.

brew upgrade logi     # 업그레이드
brew uninstall logi   # 제거

이 formula 는 RubyGems 에 배포된 logi-cli gem 을 sandbox 된 Homebrew prefix 에 설치합니다.

설치 후 곧바로:

logi              # 환영 + 다음 단계 안내
logi login        # 브라우저 OAuth 로그인
logi whoami

RubyGems (대안)

gem install logi-cli

rubygems.org/gems/logi-cli — publisher: Dcode. Ruby 3.3+ 필요.

💡 Tip: Node.js wrapper @logi-auth/* npm scope 는 SDK 전용입니다 (예: @logi-auth/browser). CLI 의 Node.js wrapper 는 현재 미제공.

직접 빌드 (선택)

소스에서 직접 빌드하려면 CLI 소스 접근이 필요합니다 — 온보딩/파트너십 과정에서 제공되며 support@1pass.dev 로 요청하세요. 대부분의 경우 위의 RubyGems 또는 Homebrew 설치를 권장합니다. Ruby 3.3+ 필요:

git clone <온보딩 시 안내받은 레포 URL> logi
cd logi/cli
bundle install
bundle exec bin/logi              # 환영 + 다음 단계 안내
bundle exec bin/logi login        # 브라우저 OAuth 로그인

PATH 에 추가하면 bundle exec 없이 logi 만 입력해 동작합니다:

echo "export PATH=\"$(pwd)/bin:\$PATH\"" >> ~/.zshrc   # 또는 ~/.bashrc
source ~/.zshrc
logi whoami

기본 endpoint 는 https://api.1pass.dev / https://start.1pass.dev. 자체 호스팅 인스턴스를 사용한다면 LOGI_API_URL / LOGI_PORTAL_URL env 로 override:

export LOGI_API_URL=http://localhost:3000
export LOGI_PORTAL_URL=http://localhost:3000

다음

설치가 끝나면 로그인으로 이동하세요.