Skip to main content
Rank recurring problems across your project or inspect one friction with its suggested fix and recent occurrences. See Frictions for families and recovery states.
  • Badges are explained under Approvals.
  • project_id is optional on most tools; without it, the server picks a project for that call only (Projects).
  • expected_organization_id is an optional string on every write tool, omitted from parameter tables; pass organization.id from get_identity (Organization check).
  • limit values above a tool’s maximum are capped, not refused.

Tools

list_frictions

List a project’s frictions. Finds what keeps going wrong for agents, in the project or any scope, and what to fix first. By default, the most runs the agent never got past come first. Read-only · CLI: oqoqo frictions list A friction is listed when one of its runs matches every filter. Result fields Each field is explained under oqoqo frictions list.

get_friction

Read one friction with its evidence. Returns its summary, impact, suggested fix, what the agent did, where it happens most, and up to ten recent occurrences with run, recovery, cited steps, and quotes. Read-only · CLI: oqoqo frictions get Result fields The friction has the fields of list_frictions, plus these: To list all the friction’s runs, call list_runs with friction_id and the same scope.

Evals and Insights tools

Run Insights to find and group frictions.

oqoqo frictions

The matching CLI commands and filters.