> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evidence.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

> Develop Evidence Studio projects locally or with the agent of your choice.

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](../features/version-control#github-integration).

## Install

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    curl -fsSL https://evidence.studio/install.sh | sh
    ```

    Installs to `/usr/local/bin` (falls back to `~/.local/bin` if not writable).
  </Tab>

  <Tab title="Windows">
    ```powershell theme={null}
    irm https://evidence.studio/install.ps1 | iex
    ```

    Installs to `%LOCALAPPDATA%\Evidence\bin` and adds it to your user PATH. Restart your terminal after install.
  </Tab>
</Tabs>

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

```bash theme={null}
evidence version
```

## Getting Started

1. **Create a project** in [Evidence Studio](https://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:
   ```bash theme={null}
   evidence login
   ```
4. **Start developing** from inside your cloned project directory:
   ```bash theme={null}
   evidence dev
   ```
5. Open a pull request on the repo. Evidence Studio will reply with a preview link. Merging the PR releases your changes.

## Upgrade

```bash theme={null}
evidence 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.