agenteye 0.1.0

Command-line client for the AgentEye dashboard API

AgentEye CLI (agenteye)

A command-line client for the AgentEye dashboard API. It lets a developer — or the coding agent working alongside them — authenticate and query agent sessions, event logs, and evaluations from the terminal, with a --json flag on every command for scripting.

This is the agenteye CLI, distinct from the collector daemon (agenteye-collector). The PyPI package and the installed command are both agenteye.

Install

pipx install agenteye      # recommended (isolated)
# or: uv tool install agenteye  /  pip install agenteye

Install isolated (pipx / uv tool) — the AgentEye Python SDK shares the agenteye distribution name, so isolation avoids a clash in a shared virtualenv.

For development in this repo:

cd cli
uv sync --extra dev
uv run agenteye --help

Authentication

The CLI talks to your dashboard (set --base-url or AGENTEYE_DASHBOARD_URL) and logs in with an emailed one-time code:

agenteye login --email [e-mail]
# enter the 6-digit code; the session is stored in ~/.agenteye/cli.json (mode 0600)
agenteye whoami
agenteye logout

Sessions expire (24h by default); re-run agenteye login when prompted.

Commands

agenteye sessions [--since 24h] [--status error] [--all]
agenteye events --session-id <id> [--event-type tool_use,tool_result] [--all]
agenteye logs ...                       # alias of events
agenteye evals --score helpfulness:0.5..0.8 --latest-per-session
agenteye session show <id>
agenteye session export <id> -o out.json
agenteye re-evaluate <id>
agenteye jobs                           # in-flight evaluation queue
agenteye environments [--source events|evals]
agenteye version                        # print the CLI version
agenteye help                           # show top-level help

Add --json to any command for machine-readable output:

agenteye events --session-id run-001 --all --json | jq '.events[].payload'

Configuration

Setting	Flag	Env var	Default
Dashboard URL	--base-url	AGENTEYE_DASHBOARD_URL	required (no default)
Session token	--token	AGENTEYE_CLI_TOKEN	from ~/.agenteye/cli.json
JSON output	--json	AGENTEYE_CLI_JSON	off

Precedence is flag > environment variable > config file. The dashboard URL is required (no default) — set --base-url or AGENTEYE_DASHBOARD_URL, or it's saved after your first login. The config directory honours AGENTEYE_HOME (same as the SDK and collector).

Exit codes

Code	Meaning
0	Success
2	Usage error (bad arguments)
3	Cannot reach the dashboard
4	Not logged in / session expired
5	Authenticated but missing permission

Tests

cd cli
uv run --extra dev pytest