Commands

Development

`evidence dev`

Start the local development server.

evidence dev
evidence dev --port 8080

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

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

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"

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

CLI

Data Sources

Components

Development

`evidence dev`

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`

Utility

`evidence version`

`evidence upgrade`

`evidence help`

Get Started

Core Concepts

Features

CLI

Data Sources

Components

​Development

​evidence dev

​Data

​evidence query

​evidence tables

​evidence describe

​evidence schema

​evidence connectors

​evidence models

​evidence lineage

​Project

​evidence validate

​evidence docs

​Authentication

​evidence login

​evidence logout

​evidence whoami

​evidence orgs

​evidence switch

​Utility

​evidence version

​evidence upgrade

​evidence help

Development

`evidence dev`

Data

`evidence query`

`evidence tables`

`evidence describe`

`evidence schema`

`evidence connectors`

`evidence models`

`evidence lineage`

Project

`evidence validate`

`evidence docs`

Authentication

`evidence login`

`evidence logout`

`evidence whoami`

`evidence orgs`

`evidence switch`

Utility

`evidence version`

`evidence upgrade`

`evidence help`