# Install Deepvista CLI

> Install the DeepVista CLI. Load when the `deepvista` binary is missing from PATH (hooks/commands return "command not found" or silently no-op), when the user asks how to install DeepVista, or when `deepvista auth login` hasn't been run yet. Ships with the DeepVista Claude Code plugin so the install path stays discoverable even before the CLI is present.

- Skill: `aibot88/install-deepvista-cli` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add aibot88/install-deepvista-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aibot88/install-deepvista-cli/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aibot88 (https://skillmd.com/u/aibot88)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/aibot88/install-deepvista-cli

---


# Install the DeepVista CLI

The DeepVista Claude Code plugin requires the `deepvista` CLI to be installed
separately. Without it, the plugin's `SessionStart` hook exits silently and
no catalog skills sync.

## Install

```bash
uv tool install 'deepvista-cli[ui]'   # preferred
# or
pip install 'deepvista-cli[ui]'
```

The `[ui]` extra adds the optional terminal UI (`deepvista ui`). Omit the
suffix for a CLI-only install.

## Authenticate

```bash
deepvista auth login      # opens a browser for OAuth
deepvista auth status     # verify
```

## Trigger a first sync

Once the CLI is installed and authenticated, force the plugin's catalog
sync without waiting for the next session start:

```
/refresh-skills
```

## Full reference

The canonical install + auth + profile reference lives with the CLI itself:
[`skills/deepvista/reference/shared.md`](https://github.com/DeepVista-AI/deepvista-cli/blob/main/skills/deepvista/reference/shared.md).
Load it for profile switching, headless-auth codes, credential paths, and
global-flag rules.