Skip to main content
bentolabs-cli is the command-line client for Bento. Anything you can do in the dashboard, you can do from your terminal, a script, or CI: triage issues, read runs, inspect signals, pull analytics. This page explains the product the CLI drives, so any command lands in the right place.

​
The command list comes from the API

Every command is generated from the Bento API. Each surface in the dashboard has a matching command group because both are built from the same source, and two things follow from that. --help at any level is the real, current signature, so reach for it whenever you’re unsure:
And the list grows when the API does. Run bentolabs refresh to pull in newly added commands. You sign in as yourself with bentolabs auth login, not with a workspace API key, so the CLI can do whatever your dashboard login can.

​
What Bento records

Bento watches your agent runs, learns what “broken” looks like for your app, and tracks the problems it finds. A handful of nouns carry the whole product, and they nest from the top down, the way you’d actually navigate. Start at an issue. An issue is a tracked problem: a recurring failure mode Bento has grouped for you, with a status, a severity, and its evidence attached. It’s the front door, and most triage starts there. Under an issue sits that evidence. A trajectory is one analyzed agent run, the unit Bento reasons over and flags as suspicious, a win, or errored. Each trajectory carries findings: single observations like “a tool call failed” or “the response drifted off the goal.” The raw recording beneath a trajectory is a run (a trace, in OpenTelemetry terms), made of spans, the individual LLM and tool calls. Across many runs, Bento looks for patterns. A signal is a detector you describe in plain English; Bento trains it on your own runs, then fires it in real time and backfills your history. Similar findings and firings group into clusters, the scatter view of what’s happening. That nesting, at a glance:
A run is the raw recording; a trajectory is that run after Bento analyzes it. You monitor trajectories and read runs when you need the raw payload.

​
How the dashboard maps to the CLI

If someone mentions a page they saw in the web app, this is where it lives in the CLI. A few platform actions stay in the dashboard. Binding a signal to a notification channel into a firing alert rule is one: the CLI trains the signal and creates the channel, but the binding happens in the web app. When no command fits, the raw escape hatch can hit a path directly.

​
Next

Install and sign in

Get the CLI, sign in, pick a workspace.

Commands

How arguments, request bodies, and output modes work.

Start with Issues

The front door for triage.

Python SDK

Send the runs the CLI reads.