CLI: Agents
Generated from deedglass help --json (CLI 0.1.0-dev). Global flags and exit codes are on the CLI reference page.
deedglass agent create
Section titled “deedglass agent create”Register an agent.
deedglass agent create <name> [--description …] [--label env=prod]... [--calls-per-minute n] [--calls-per-day n] [--spend-per-day minor --currency usd] [--owner usr_…] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--calls-per-day |
int | 0 |
budget: calls per day |
--calls-per-minute |
int | 0 |
budget: calls per minute (S11 enforces it) |
--currency |
string | usd |
the spend budget’s ISO 4217 currency, lowercase |
--description |
string | what the agent does, up to 500 characters | |
--label |
string | a label key=value (repeatable): env=prod | |
--owner |
string | the person responsible (usr_…) | |
--spend-per-day |
int | 0 |
budget: spend per day in minor units (5000 = $50.00), with –currency |
Add --json for machine-readable output.
deedglass agent list
Section titled “deedglass agent list”List agents.
deedglass agent list [--status active|suspended|stopped] [--label env:prod] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--label |
string | only agents with this label, key:value (env:prod) | |
--status |
string | active, suspended or stopped |
Add --json for machine-readable output.
deedglass agent show
Section titled “deedglass agent show”Show one agent.
deedglass agent show <name|agt_…> [--json]Add --json for machine-readable output.
deedglass agent suspend
Section titled “deedglass agent suspend”Suspend an agent.
deedglass agent suspend <name|agt_…> [--reason …] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--reason |
string | why; it goes into the record (required for start) |
Add --json for machine-readable output.
deedglass agent resume
Section titled “deedglass agent resume”Resume a suspended agent.
deedglass agent resume <name|agt_…> [--reason …] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--reason |
string | why; it goes into the record (required for start) |
Add --json for machine-readable output.
deedglass agent stop
Section titled “deedglass agent stop”Stop an agent now.
deedglass agent stop <name|agt_…> [--reason …] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--reason |
string | why; it goes into the record (required for start) |
Add --json for machine-readable output.
deedglass agent start
Section titled “deedglass agent start”Start a stopped agent.
deedglass agent start <name|agt_…> --reason "why it's safe now" [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--reason |
string | why; it goes into the record (required for start) |
Add --json for machine-readable output.
deedglass agent keys create
Section titled “deedglass agent keys create”Create an API key for an agent.
deedglass agent keys create <name|agt_…> [--name "prod runner"] [--mode live|test] [--scope …]... [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--mode |
string | live |
live or test (test keys are recorded as livemode false) |
--name |
string | a name for the key, like prod runner | |
--scope |
string | a scope (repeatable); default actions:execute, actions:read, deeds:read |
Add --json for machine-readable output.
deedglass agent keys list
Section titled “deedglass agent keys list”List an agent’s API keys.
deedglass agent keys list <name|agt_…> [--json]Add --json for machine-readable output.
deedglass agent keys roll
Section titled “deedglass agent keys roll”Replace an API key, with an overlap.
deedglass agent keys roll <key_…> [--overlap 24h] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--overlap |
duration | 24h0m0s |
how long the old key keeps working: 0s to 168h |
Add --json for machine-readable output.
deedglass agent keys revoke
Section titled “deedglass agent keys revoke”Revoke an API key.
deedglass agent keys revoke <key_…> [--reason …] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--reason |
string | why; it goes into the record (required for start) |
Add --json for machine-readable output.
deedglass agent intent keygen
Section titled “deedglass agent intent keygen”Generate a signed-intent key pair.
deedglass agent intent keygen <name> [--dir .deedglass/intent] [--force] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--dir |
string | .deedglass/intent |
where to write |
--force |
bool | replace an existing key file |
Add --json for machine-readable output.
deedglass agent intent add
Section titled “deedglass agent intent add”Register an intent public key.
deedglass agent intent add <name|agt_…> --public-key ed25519:… [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--public-key |
string | the public key keygen printed, “ed25519:…” |
Add --json for machine-readable output.
deedglass agent intent list
Section titled “deedglass agent intent list”List an agent’s intent keys.
deedglass agent intent list <name|agt_…> [--json]Add --json for machine-readable output.
deedglass agent intent remove
Section titled “deedglass agent intent remove”Remove an intent key.
deedglass agent intent remove <name|agt_…> <kid> [--json]Add --json for machine-readable output.
deedglass agent intent mode
Section titled “deedglass agent intent mode”Require, allow or ignore signed intents.
deedglass agent intent mode <name|agt_…> off|optional|required [--json]Add --json for machine-readable output.
deedglass org create
Section titled “deedglass org create”Create an org and its owner.
deedglass org create --name "Acme" --owner-email priya@acme.com [--slug acme] [--print-link] [--admin-key] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--admin-key |
bool | also create an org admin key and print it once (S08) | |
--name |
string | the org’s name, as people see it (required) | |
--owner-email |
string | the first owner’s email address (required) | |
--print-link |
bool | prod: print the owner’s sign-in link instead of emailing it | |
--slug |
string | the org’s short name in URLs (default: from the name) |
Add --json for machine-readable output.
deedglass org login-link
Section titled “deedglass org login-link”Print a one-time sign-in link.
deedglass org login-link --email sam@acme.com [--org acme] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--email |
string | the member’s email address (required); –org picks the org |
Add --json for machine-readable output.
deedglass org keys create
Section titled “deedglass org keys create”Create an org admin key.
deedglass org keys create [--org acme] [--name ci] [--mode live|test] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--mode |
string | live |
live or test |
--name |
string | a name for the key, like ci |
Add --json for machine-readable output.
deedglass org keys list
Section titled “deedglass org keys list”List org admin keys.
deedglass org keys list [--org acme] [--json]Add --json for machine-readable output.
deedglass org keys revoke
Section titled “deedglass org keys revoke”Revoke an org admin key.
deedglass org keys revoke <key_…> [--org acme] [--reason …] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--reason |
string | why; it goes into the record (required for start) |
Add --json for machine-readable output.
deedglass org stop-all
Section titled “deedglass org stop-all”Stop every agent in the org.
deedglass org stop-all [--reason …] [--yes] [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--reason |
string | why; it goes into the record | |
--yes |
bool | skip the typed confirmation (scripts) |
Add --json for machine-readable output.
deedglass org start-all
Section titled “deedglass org start-all”Start every agent not stopped one by one.
deedglass org start-all [--org acme] --reason "why it's safe now" [--json]| Flag | Type | Default | What it does |
|---|---|---|---|
--reason |
string | why; it goes into the record (required for start) |
Add --json for machine-readable output.