Your company's brain, scripted from the terminal.

Install

Install via npm. Node 20.10 or newer is required.

npm i -g @quelvio/cli
quelvio --version

git clone https://github.com/Quelvio/quelvio-cli
cd quelvio-cli
pnpm install
pnpm build
node dist/index.js --version

Quickstart

Three commands and you're querying production knowledge.

1. Generate a Personal Access TokenSign in to the dashboard at enterprise.quelvio.com/account, open Personal API Keys, and click Create token. Tokens are scoped to your individual identity — every query you run is attributed to you and respects your per-source permissions. enterprise.quelvio.com/account
2. Export it
   shCopy

   export QUELVIO_TOKEN=qlv_pat_<your-key>

3. Verify auth, then ask the brain a question
   shCopy

   quelvio whoami
   quelvio query "what is our deployment process?"

Authentication

quelvio resolves a token from the following sources, in order, and uses the first non-empty one. The token is never echoed to stdout, stderr, or logs — --verbose HTTP traces redact the Authorization header.

Authentication methods

1. PAT· available nowA long-lived bearer token tied to a human user. Every query is attributed to that user; permissions and rate limits apply per identity. Generate one at enterprise.quelvio.com/account.
2. OAuth login· plannedquelvio login will perform a browser-based device-code flow and stash the resulting token in your OS keychain.
3. Service accounts· plannedFor headless agents and CI bots that need an identity distinct from a human's.

Commands

Every command supports the global flags --token <t>, --json, --no-color, --verbose, and --quiet. Run quelvio <command> --help for the full flag list.

quelvio query "what is our incident response policy?"
quelvio query --mode deep --max-sources 8 "compare our Q3 vs Q4 deployment cadence"
quelvio query --domain engineering.platform "who owns the auth middleware?"
echo "draft a release note for v1.4" | quelvio query
quelvio query --json "what is our SLA?" | jq '.synthesis'

<synthesized answer with [1] [2] citation markers>

Sources:
  [1] runbooks/incident-response.md (confluence) — [email protected], 3d ago
  [2] eng-week-2026-04-15.slack (slack) — [email protected], 2w ago

Query ID: 9f3a-...  ·  Coverage: high  ·  kT: 12500  ·  1820ms

quelvio domains
quelvio domains --json | jq '.domains[].taxonomy_domain'

quelvio source 9f3a4d8c-7b2e-4a3d-b1c5-1f2e3d4a5b6c
quelvio source 9f3a... --json

quelvio whoami
quelvio whoami --json

Signed in as: [email protected]
Tenant:       ACME Corp (aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee)
Auth method:  pat
Token prefix: qlv_pat_a1b2...

quelvio config list
quelvio config get default_mode
quelvio config set default_mode deep
quelvio config set default_max_sources 8
quelvio config set api_base https://api.staging.quelvio.com
quelvio config unset api_base

Configuration

Environment variables and files that control CLI behavior.

Exit codes

Stable exit codes so scripts can branch on outcome without parsing stderr.

Output formats

Humans. The default output is prose with ANSI color, citation bolding, and a metadata footer. Colors auto-disable when stdout is not a TTY or when NO_COLOR is set.

Agents and scripts. Add --json to any command for a machine-readable response. Pretty-printed when stdout is a TTY, compact when piped — always parseable by jq.

quelvio query "what is our SLA?" --json | jq -r '.synthesis'
quelvio domains --json | jq -r '.domains[] | "\(.taxonomy_domain)\t\(.document_count)"'

Examples

Patterns we use ourselves.

QUELVIO_TOKEN="qlv_pat_..." \
  quelvio query --json "summarize our security policies" \
  | jq -r '.synthesis' \
  | tee summary.md

name: nightly-knowledge-digest
on:
  schedule:
    - cron: '0 13 * * *'
jobs:
  digest:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npm i -g @quelvio/cli
      - name: Generate digest
        env:
          QUELVIO_TOKEN: ${{ secrets.QUELVIO_PAT }}
        run: |
          quelvio query "what changed in eng this week?" --mode deep --json \
            | jq -r '.synthesis' > digest.md
      - uses: actions/upload-artifact@v4
        with:
          name: digest
          path: digest.md

quelvio query "what is the rollback procedure for production deploys?"

Troubleshooting

Most failures fall into a handful of buckets. --verbose adds HTTP trace lines to stderr — useful when reporting issues.

Links & references