opschain recommendations list
packs:agent-governance
opschain recommendations list <project> [--status <status>] [--agent <code>] [--wide]
Lists the project's recommendations as a table, newest first as the server orders them. Rows whose subject node the login cannot read are not returned.
Columns: ID, STATUS, AGENT, LANE (the filing instance's lane —
stable when the agent runs a single instance), NODE, TITLE,
CORRELATION (the triggering incident's chain id) and DUPLICATES — for
an open card the number of proposals linked to it with their lanes
(1 (shadow)), for a duplicate the open card it links to (duplicate of <id>), - otherwise. A project with no recommendations prints
no recommendations.
Flags
| Flag | Meaning |
|---|---|
--status <status> | Server-side filter: open, accepted, dismissed, expired, superseded or duplicate. |
--agent <code> | Server-side filter on the filing agent's code. |
--wide | Full ids, the untrimmed node path, and the CREATED column (default: ids cut to 13 characters, paths to their last 4 segments). |
--filter <column>[!]=<value> | Keep only rows matching the term (repeatable; terms AND). Columns are the printed table headers lowercased; * wildcards match the whole cell case-insensitively, != negates, commas mean any-of. Applied client-side. Grammar: opschain docs cli. |
-o json|yaml prints the recommendation resources as the server sent them
(lane, correlation_id, duplicate_of, duplicates[] included).
Exit codes
| Code | Meaning |
|---|---|
| 0 | Listed (including an empty list). |
| 1 | The request failed (unknown project, missing packs:agent-governance, network, auth). |
| 2 | Usage error — no server target, wrong arguments. |
Named errors
recommendations live on a server's projects — pass --server <url> or 'opschain context use <name>'— the command ran without a server target; exit 2.
Examples
opschain recommendations list demo --status open
opschain recommendations list demo --agent felix --filter 'lane=shadow'