---
title: Install and authenticate
description: Install a pinned Sift CLI, authenticate, and verify the connection.
product: cli
lifecycle: stable
appliesTo: "@sift-wiki/cli@0.1.10"
sourceArtifact: "@sift-wiki/cli@0.1.10"
verifiedAt: "2026-07-13"
owner: CLI owner
raw: /raw/cli/install.md
---

Requires Node.js 20 or newer.

```bash
npm install -g @sift-wiki/cli@0.1.10
npm view @sift-wiki/cli@0.1.10 version
sift auth status --json
sift login
sift doctor --json
```

`sift login` opens browser authorization and stores a refreshable local profile in the operating-system credential store. `auth status` should move from an unauthenticated result to a selected workspace/brain scope without printing a token.

`doctor` checks auth, scope, API reachability, and tool availability independently. A non-OK result can identify a missing capability or runtime tool even when login and read access succeeded; follow the failed check instead of repeating login blindly.

## Zero-install

```bash
npx -y @sift-wiki/cli@0.1.10 auth status --json
npm exec --yes --package @sift-wiki/cli@0.1.10 -- sift doctor --json
```

## Upgrade or remove

```bash
npm install -g @sift-wiki/cli@latest
npm uninstall -g @sift-wiki/cli
```

Pin an exact version in automation. Use `@latest` only for interactive setup where accepting an upgrade is intentional.
