Skip to content
OneQuery OneQuery Docs

Install the CLI

The CLI is the main local surface for setup and source access.

Install Options

Section titled “Install Options”
Terminal window
npm install -g @onequery/cli

Run Without Installing Globally

Section titled “Run Without Installing Globally”
Terminal window
npx @onequery/cli --help

Verify

Section titled “Verify”
Terminal window
onequery --version
onequery --help

Auth

Section titled “Auth”
Terminal window
onequery auth login
onequery auth whoami

CLI State

Section titled “CLI State”

The CLI stores the default auth session and config under ~/.onequery/. Set ONEQUERY_HOME when you need an isolated state directory for a test environment or agent runtime.

Named profiles keep separate state:

Terminal window
onequery --profile work auth login
ONEQUERY_PROFILE=work onequery auth whoami

Use profiles for separate production, staging, or customer environments.