Skip to main content
The Evidence CLI lets you run and develop Evidence projects locally from the command line. It includes a development server for previewing your reports locally as you work, commands for running queries, viewing metadata, and validating your code. If you are going to use the CLI for development, you should set up the GitHub Integration.

​
Install

Installs to /usr/local/bin (falls back to ~/.local/bin if not writable).
Both evidence and evd commands are available after install.

​
Supported Platforms

  • macOS arm64 (Apple Silicon)
  • macOS x64 (Intel)
  • Linux x64
  • Linux arm64
  • Windows x64

​
Verify Installation

​
Getting Started

  1. Create a project in Evidence Studio and connect it to a GitHub repo.
  2. Clone the repo to your local machine.
  3. Log in to your Evidence account via the CLI:
  4. Start developing from inside your cloned project directory:
  5. Open a pull request on the repo. Evidence Studio will reply with a preview link. Merging the PR releases your changes.

​
Upgrade

The CLI checks for updates on startup. If a newer version is available, you’ll see a warning. If your version is below the minimum supported version, the CLI will require an upgrade before running.