chio agent

Create a demonstration caller that holds its own key, then drive traffic from it against a service you published.

On this page

chio agent

Run demonstration agents against a service you publish.

Command synopsistext

chio agent [OPTIONS] <COMMAND>

chio agent demo Create a demonstration caller, or drive demo traffic from one.
chio agent token Print the capability token a caller holds, for use as a bearer credential.

Example

Create a caller for the published pricing service.

Terminalbash

chio agent demo --out caller.json

Output

agent      did:chio:z6MkbY4…e1R
key        held by the agent, not by your kernel
connects   https://127.0.0.1:9440/pricing/mcp

chio agent demo

Create a demonstration caller, or drive demo traffic from one.

Command synopsistext

chio agent demo [OPTIONS]

--out <OUT> Write the new caller’s connection file to this path.
--traffic <TRAFFIC> Send demo traffic as the caller described by this connection file.
--with-stranger Also send calls from a second agent that holds no grant.

Additional behavior

The caller holds its own key; your kernel holds none of it. With --traffic, the caller calls the service under its grant, including calls the grant does not cover, and each refusal and pending approval appears in the live call stream.

chio agent token

Print the capability token a caller holds, for use as a bearer credential.

Command synopsistext

chio agent token [OPTIONS] <CALLER>

<CALLER> Connection file written by chio agent demo --out. Required.

Additional behavior

Reads the caller’s connection file and prints its current grant token on stdout and a one-line summary on stderr, so the output can be captured into an environment variable.