---
title: "CLI"
description: "Release notes for the PandaProbe CLI"
icon: "terminal"
rss: true
---

Release history for the **PandaProbe CLI** (`pandaprobe`).

Current version: `v0.2.0`

<Update label="v0.2.0" description="2026-06-26" tags={["Feature"]}>
  ### Evaluation monitors

  Manage scheduled evaluation monitors entirely from the CLI with the new `evals monitors` command group. See the [CLI docs](/introduction/cli#monitors) for details.

  - **Monitor lifecycle**: `evals monitors create`, `list`, `get`, `update`, `delete`, `pause`, `resume`, `runs`, and `trigger` — wrapping the evaluation-monitor API so monitors are managed with the same auth, config, and output as every other command.
  - **Scheduling**: predefined cadences (`every_6h`, `daily`, `weekly`) or a custom `cron:<5-field expression>`, with `--sampling-rate`, `--model`, and `--only-if-changed` controls.
  - **Targeting**: `create` derives `TRACE` / `SESSION` scope from `--target`, reuses the same per-target filter flags as `evals runs create`, and accepts `--signal-weights` for session monitors.
  - **Filtering & output**: `list` filters by `--status ACTIVE|PAUSED` with `--limit` / `--offset`; JSON by default with `--format table` support for monitor and run listings.
</Update>

<Update label="v0.1.0" description="2026-06-03" tags={["Initial release"]}>
  ### Public release of the PandaProbe CLI

  A single-binary, agent-first command-line tool for working with the PandaProbe API from your terminal. See the [CLI docs](/introduction/cli) to get started.

  - **Traces & sessions**: `traces list` / `get` / `spans` and `sessions list` / `get`, with rich server-side filtering (status, user, tags, date range, sort) and `--limit` / `--offset` pagination.
  - **Evaluations**: `evals metrics`, `evals runs` (`create`, `batch`, `list`, `get`, `scores`), and `evals scores` (`list`, `get`, `submit`), targeting traces or sessions via `--target trace|session`.
  - **Authentication**: `pandaprobe auth login` performs a browser-based OAuth 2.0 Authorization-Code + PKCE flow against PandaProbe Cloud, mints a 90-day API key, and stores it in `~/.pandaprobe/config.yaml` — the raw key never travels through the browser. Plus `auth status` / `auth logout`, and a manual API-key path (`config set`) for self-hosted deployments.
  - **Agent-first output**: JSON by default (data to stdout, errors as JSON to stderr), meaningful exit codes (`0`/`1`/`2`/`3`/`4`/`5`), and an opt-in `--format table` for humans.
  - **Configuration**: precedence of flags → `PANDAPROBE_*` environment variables → `~/.pandaprobe/config.yaml` → defaults; inspect with `config show`.
  - **Install**: one-line `curl` (macOS/Linux) and `irm` (Windows) installers via `cli.pandaprobe.com`, `go install`, and prebuilt binaries for Linux, macOS, and Windows (amd64/arm64) on each GitHub release.
  - **Shell completion** for bash, zsh, fish, and PowerShell.
</Update>
