CLI: Actions
Generated from deedglass help --json (CLI 0.1.0-dev). Global flags and exit codes are on the CLI reference page.
deedglass act
Section titled “deedglass act”Send a test action through Deedglass.
deedglass act <tool> [--args '{"k":"v"}'] [--mode gateway|proxy] [--wait 60s] [--idempotency-key K] [--json]Add --json for machine-readable output.
deedglass actions list
Section titled “deedglass actions list”List actions.
deedglass actions list [--agent agt_…] [--tool stripe.*] [--state …] [--decision …] [--verdict MISMATCH] [--level L2] [--since 1h] [--q text] [--limit 25] [--cursor …] [--json] [--follow] [--connector orders]| Flag | Type | Default | What it does |
|---|---|---|---|
--agent |
string | an agent id (agt_…) | |
--connector |
string | only this connector’s tools ( |
|
--cursor |
string | next_cursor from the previous page | |
--decision |
string | comma list: allow, deny, require_approval | |
--follow |
bool | keep printing actions as they are decided and sealed (Ctrl-C to stop) | |
--level |
string | comma list: L0, L1, L2 | |
--limit |
int | 25 |
page size, 1 to 100 |
--on-behalf-of |
string | an on-behalf-of reference | |
--q |
string | text in the tool name or error code | |
--since |
duration | 0s |
only actions newer than this (1h, 30m) |
--state |
string | comma list of states | |
--tool |
string | a tool name, or a glob with * (stripe.*) | |
--verdict |
string | comma list: VERIFIED, MISMATCH, UNVERIFIABLE |
Add --json for machine-readable output.
deedglass actions show
Section titled “deedglass actions show”Show one action, its events and its Proven diff.
deedglass actions show <act_…> [--wait] [--diff] [--json]Add --json for machine-readable output.
deedglass actions cancel
Section titled “deedglass actions cancel”Cancel a pending action.
deedglass actions cancel <act_…> [--json]Add --json for machine-readable output.
deedglass approve
Section titled “deedglass approve”Approve a pending action.
deedglass approve <apr_…> --as <email> [--reason …] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--as |
string | dev only: the member who decides (their email) | |
--reason |
string | why (required to deny; the agent sees it) |
Add --json for machine-readable output.
deedglass deny
Section titled “deedglass deny”Deny a pending action.
deedglass deny <apr_…> --as <email> --reason "…" [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--as |
string | dev only: the member who decides (their email) | |
--reason |
string | why (required to deny; the agent sees it) |
Add --json for machine-readable output.
deedglass approvals list
Section titled “deedglass approvals list”List approvals.
deedglass approvals list [--status pending] [--agent <name>] [--limit 25] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--agent |
string | an agent id or name | |
--limit |
int | 25 |
at most this many (1 to 100) |
--status |
string | pending |
pending, approved, denied, expired, cancelled, or a comma-separated list |
Add --json for machine-readable output.
deedglass approvals show
Section titled “deedglass approvals show”Show one approval.
deedglass approvals show <apr_…> [--json]Add --json for machine-readable output.
deedglass undo preview
Section titled “deedglass undo preview”Show what an undo would change.
deedglass undo preview <act_…> [--allow-triggers] [--steps N] [--json]Add --json for machine-readable output.
deedglass undo run
Section titled “deedglass undo run”Undo an action.
deedglass undo run <act_…> --plan <sha256:…> --reason "…" [--allow-triggers] [--wait 25s] [--json]Add --json for machine-readable output.
deedglass observe run
Section titled “deedglass observe run”Watch a database while a command runs.
deedglass observe run --connector <name> [--label "…"] [--agent <name>] -- <command …>Add --json for machine-readable output.
deedglass observe start
Section titled “deedglass observe start”Open a watched session.
deedglass observe start --connector <name> [--label "…"] [--agent <name>] [--json]Add --json for machine-readable output.
deedglass observe stop
Section titled “deedglass observe stop”Close a watched session.
deedglass observe stop <obs_…> [--wait=false] [--json]Add --json for machine-readable output.
deedglass observe list
Section titled “deedglass observe list”List watched sessions.
deedglass observe list [--connector <name>] [--state sealed] [--caught] [--limit 20] [--json]Add --json for machine-readable output.
deedglass observe show
Section titled “deedglass observe show”Show a session or print its undo SQL.
deedglass observe show <obs_…> [--undo-sql] [--json]Add --json for machine-readable output.
deedglass observe undo
Section titled “deedglass observe undo”Undo a whole session in one step (Pro).
deedglass observe undo <obs_…> --reason "…" [--allow-triggers] [--wait 25s] [--json]Add --json for machine-readable output.
deedglass observe exclude
Section titled “deedglass observe exclude”Leave a transaction out of an undo.
deedglass observe exclude <obs_…> <dtx_…> [--include] [--json]Add --json for machine-readable output.
deedglass webhooks create
Section titled “deedglass webhooks create”Add a webhook endpoint.
deedglass webhooks create --url <url> --events approval.requested,approval.decided [--description …] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--description |
string | a note for people, at most 200 characters | |
--events |
string | comma-separated event types, for example approval.requested,approval.decided | |
--url |
string | the endpoint (https; http://localhost in dev) |
Add --json for machine-readable output.
deedglass webhooks list
Section titled “deedglass webhooks list”List webhook endpoints.
deedglass webhooks list [--json]Add --json for machine-readable output.
deedglass webhooks test
Section titled “deedglass webhooks test”Send a test event.
deedglass webhooks test <whk_…> [--json]Add --json for machine-readable output.
deedglass webhooks delete
Section titled “deedglass webhooks delete”Remove a webhook endpoint.
deedglass webhooks delete <whk_…> [--json]Add --json for machine-readable output.