Installation

RubyGems (recommended)

gem install logi-cli

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

Right after installing:

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

Homebrew

brew install dcode-co/logi/logi

Tap repository: github.com/dcode-co/homebrew-logi. This formula installs the logi-cli gem published on RubyGems into a sandboxed Homebrew prefix.

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.