Installation

Source: en/cli/install.md · Live: https://docs.1pass.dev/en/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 (recommended)
• L40-L50: ## RubyGems (alternative)
• L51-L77: ## Build from source (optional)
• L78-L81: ## Next

---

Installation

Homebrew (recommended)

brew install dcode-co/logi/logi

The first run auto-registers the tap repository (github.com/dcode-co/homebrew-logi). After that, manage it by its short name — brew upgrade logi to upgrade, brew uninstall logi to remove.

brew upgrade logi     # upgrade
brew uninstall logi   # remove

This formula installs the logi-cli gem published on RubyGems into a sandboxed Homebrew prefix.

Right after installing:

logi              # welcome message and next steps
logi login        # browser OAuth login
logi whoami

RubyGems (alternative)

gem install logi-cli

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

💡 Tip: Node.js wrapper The @logi-auth/* npm scope is for SDKs only (for example, @logi-auth/browser). A Node.js wrapper for the CLI is not available yet.

Build from source (optional)

To build from source you need CLI source access — it's provided during onboarding/partnership; request it at support@1pass.dev. For most cases, prefer the RubyGems or Homebrew install above. Requires Ruby 3.3+:

git clone <repo URL provided during onboarding> logi
cd logi/cli
bundle install
bundle exec bin/logi              # welcome message and next steps
bundle exec bin/logi login        # browser OAuth login

Add it to your PATH so you can run logi directly, without bundle exec:

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

The default endpoints are https://api.1pass.dev and https://start.1pass.dev. If you run a self-hosted instance, override them with the LOGI_API_URL and LOGI_PORTAL_URL environment variables:

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

Next

Once installation is complete, head to Login.