# DeepVista CLI

DeepVista CLI connects your coding agents (Claude Code, Cursor, OpenCode) to a
shared knowledge base, so they don't just execute but learn, remember, and build
on past work. Your knowledge base is accessible from any terminal.

Docs: https://github.com/DeepVista-AI/deepvista-cli
Web app: https://app.deepvista.ai

## Install

### macOS / Linux

One-liner (auto-detects uv, pipx, or pip and installs the agent skill):

    curl -sSL https://raw.githubusercontent.com/DeepVista-AI/deepvista-cli/main/install.sh | bash

Or install the package directly:

    uv tool install deepvista-cli    # or: pipx install deepvista-cli, or: pip install deepvista-cli

### Windows (PowerShell)

    powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/DeepVista-AI/deepvista-cli/main/install.ps1 | iex"

Or install the package directly:

    uv tool install deepvista-cli    # or: pipx install deepvista-cli, or: pip install deepvista-cli

## Authenticate

    deepvista auth login                   # opens the browser (default)

Headless / non-interactive (no browser): visit https://app.deepvista.ai/cli,
sign in, copy the code shown, then run:

    deepvista auth login --code XXXX-XXXX

## Verify

    deepvista --version
    deepvista auth status

## Claude Code plugin (recommended for Claude Code users)

Install the CLI first (the plugin calls it under the hood), then, inside Claude Code:

    /plugin marketplace add DeepVista-AI/deepvista-cli
    /plugin install deepvista@deepvista-ai

The plugin syncs the DeepVista skill catalog into Claude Code on every
SessionStart and ships the auto-capture hook. Without the CLI on PATH the
SessionStart hook exits silently (no skills, no errors).

## First commands

    deepvista notes +quick "My first note from the terminal"
    deepvista card +search "founder mindset"
    deepvista chat +send "What did I learn last week?"

## Troubleshooting (Windows)

If you see "uv trampoline failed to canonicalize script path" when running
deepvista on Windows:

  1. Upgrade uv, then reinstall the tool:

        uv self update
        uv tool install deepvista-cli --force

  2. Or run it without an installed trampoline:

        uv tool run deepvista --version

  3. Avoid installing into directories whose paths contain spaces.

## Uninstall

    curl -sSL https://raw.githubusercontent.com/DeepVista-AI/deepvista-cli/main/uninstall.sh | bash