Grida Agent from the CLI
The source-built native CLI supports grida agent run for scripts and
grida agent serve --stdio for Agent Client Protocol clients. Select a Gateway
model and, when needed, a funding organization. Use a private state directory
to keep your chats across launches.
For setup, commands, exit codes, and the available client controls, see Connect an agent client.
Run a local ACP peer
On macOS and Linux, grida agent run-external --profile FILE --state-dir DIRECTORY
gives one text prompt to a reviewed ACP v1 stdio peer. Supply an existing
private state directory and a matching native sandbox helper. The private
profile selects a system executable under administrator control, its digest,
the helper's path and digest, and the workspace and runtime paths. Linux
also requires compatible bubblewrap. The peer can read the selected workspace
and runs with networking denied.
Supply --prompt or close stdin after sending the text. Stdout carries JSON
Lines for acceptance and the final outcome, including the local receipt ID.
Each invocation starts a fresh peer process. See the
confined peer profile and recovery reference.