CLI

The evidentsource CLI scripts the same operations you’d do from a UI or SDK — designed for CI pipelines, demos, and quick operational work.

Install

# macOS / Linux
curl -fsSL https://sandbox.evidentsource.com/install.sh | sh

# Or build from source
cargo install evidentsource-cli

Configure

Point the CLI at an endpoint:

evidentsource config set endpoint https://sandbox.evidentsource.com
evidentsource config set database todomvc

For your own deployment, also set an authentication token.

Common commands

Commands & events

# Issue a command
evidentsource command send CreateTodo --subject todo-1 --data '{"title":"Hi"}'

# Query events
evidentsource events query --subject todo-1

State views

evidentsource state-view read todo-list
evidentsource state-view read single-todo --todoId todo-1 --as-of 2026-04-20T00:00:00Z

Sandbox deploys

evidentsource sandbox deploy --project ./my-project --database my-todos

Administration

evidentsource db list
evidentsource db create my-db
evidentsource components list --database my-db

Shell completion

evidentsource completion fish > ~/.config/fish/completions/evidentsource.fish
evidentsource completion bash > /etc/bash_completion.d/evidentsource
evidentsource completion zsh > "${fpath[1]}/_evidentsource"

Help

evidentsource --help and evidentsource <subcommand> --help are the authoritative references.