Commands

Development

`evidence init`

Scaffold a new Evidence project.

evidence init my-project
evidence init my-project --warehouse snowflake

Option	Description
`--warehouse`	Scaffold a `connection.yaml` for a direct warehouse connection: `snowflake` or `bigquery`. See Connecting a Warehouse.

Without --warehouse, the project uses the managed Evidence Warehouse. With it, the CLI writes a connection.yaml (gitignored) so queries run directly against your own warehouse.

`evidence dev`

Start the local development server.

evidence dev
evidence dev --port 8080

Option	Description
`--port`, `-p`	Port to run on (default: 3000)

Deploy

`evidence launch`

Connect this project to Evidence Studio and GitHub, then deploy by pushing to your repo. Interactive by default — it walks you through installing the GitHub App and creating (or linking) the Studio project.

evidence launch
evidence launch --name "My Project" --upload-credentials

Option	Description
`--name`	Name for the Studio project to create.
`--branch`	Branch to publish from (default: auto-detected).
`--root-directory`	Project root within the repo (default: auto-detected).
`--upload-credentials`	Upload warehouse credentials from `connection.yaml` to your org. Prompted for interactively; required to opt in when running non-interactively.

`evidence link`

Attach this repo to an existing Studio project. The project’s content becomes git-managed — the next git push overwrites it with the repo’s contents.

evidence link my-project
evidence link --project my-project

Option	Description
`--project`	Studio project to attach, by slug or id. Also accepted as a positional argument.
`--branch`	Branch to publish from (default: auto-detected).
`--root-directory`	Project root within the repo (default: auto-detected).

`evidence unlink`

Disconnect this repo from its Studio project. The org’s GitHub App install and the project itself are left intact.

evidence unlink
evidence unlink --project my-project

Option	Description
`--project`	Studio project to unlink, by slug or id. Inferred from the repo’s binding when omitted. Also accepted as a positional argument.

Data

`evidence query`

Run a SQL query against connected data sources.

evidence query "SELECT * FROM orders LIMIT 10"
evidence query --file query.sql
cat query.sql | evidence query -

Option	Description
`--format`	Output format: `json` (default), `jsonl`, `table`, `csv`
`--limit`, `-l`	Limit number of rows
`--quiet`, `-q`	Suppress status messages
`--columns`	Output only column names and types
`--file`	Read SQL from a file
`--output`, `-o`	Write results to a file

`evidence tables`

List available data tables.

evidence tables

`evidence describe`

Show schema for a table.

evidence describe demo_daily_orders

`evidence schema`

Show all tables with their columns.

evidence schema

`evidence connectors`

List all connectors with health status.

evidence connectors
evidence connectors --json

Shows connector name, type, status, last sync, schedule, table count, and reference count for all connector types.

`evidence models`

List all models with refresh status.

evidence models
evidence models --json

Shows model name, status, last refresh time, and schedule.

`evidence lineage`

Show where connections and tables are used across projects, pages, models, and queries.

evidence lineage
evidence lineage table orders
evidence lineage --branch dev/alex
evidence lineage --json

Option	Description
`table <name>`	Show where a specific table is referenced
`--branch`	Query a specific branch (default: main)
`--json`	Output JSON for tooling

Project

`evidence validate`

Validate all markdown files in the current project.

evidence validate
evidence validate --json

`evidence docs`

Browse and search component documentation.

evidence docs                         # Overview
evidence docs search "chart"          # Search docs
evidence docs component bar_chart     # Component details

Authentication

Create an account and workspace. Opens Evidence in your browser; once done, run evidence login to connect the CLI.

evidence signup

Authenticate with Evidence Studio using your browser.

evidence login

`evidence logout`

Clear stored credentials.

evidence logout

`evidence whoami`

Show the currently authenticated user.

evidence whoami

`evidence orgs`

List available organizations.

evidence orgs

`evidence switch`

Switch to a different organization.

evidence switch "My Organization"

`evidence token`

Generate a token for headless/CI use. Prints an EVIDENCE_AUTH_TOKEN value you can set as an environment variable to authenticate without an interactive login. Requires an active login and a selected organization.

evidence token

The generated token contains a long-lived access token. Treat it as a secret.

Utility

`evidence version`

Print the current CLI version.

evidence version

`evidence upgrade`

Upgrade to the latest CLI version.

evidence upgrade

`evidence help`

Show help and available commands.

evidence help

Get Started

Core Concepts

Features

MCP

CLI

Warehouses

Evidence Warehouse

Components

Development

`evidence init`

`evidence dev`

Deploy

`evidence launch`

`evidence link`

`evidence unlink`

Data

`evidence query`

`evidence tables`

`evidence describe`

`evidence schema`

`evidence connectors`

`evidence models`

`evidence lineage`

Project

`evidence validate`

`evidence docs`

Authentication

`evidence logout`

`evidence whoami`

`evidence orgs`

`evidence switch`

`evidence token`

Utility

`evidence version`

`evidence upgrade`

`evidence help`

​Development

​evidence init

​evidence dev

​Deploy

​evidence launch

​evidence link

​evidence unlink

​Data

​evidence query

​evidence tables

​evidence describe

​evidence schema

​evidence connectors

​evidence models

​evidence lineage

​Project

​evidence validate

​evidence docs

​Authentication

​evidence signup

​evidence login

​evidence logout

​evidence whoami

​evidence orgs

​evidence switch

​evidence token

​Utility

​evidence version

​evidence upgrade

​evidence help

Development

`evidence init`

`evidence dev`

Deploy

`evidence launch`

`evidence link`

`evidence unlink`

Data

`evidence query`

`evidence tables`

`evidence describe`

`evidence schema`

`evidence connectors`

`evidence models`

`evidence lineage`

Project

`evidence validate`

`evidence docs`

Authentication

`evidence signup`

`evidence login`

`evidence logout`

`evidence whoami`

`evidence orgs`

`evidence switch`

`evidence token`

Utility

`evidence version`

`evidence upgrade`

`evidence help`