Command-line interface

Invoke commands on the compiled binary:

./my_agent <command>

Use ./my_agent --help to list commands and ./my_agent <command> --help for command options. ./my_agent --version prints the application version.

run

./my_agent run [OPTIONS] <INPUT>

Send INPUT as a user message and consume the run's event stream until it ends.

human prints reasoning, assistant text, tool activity, and the final run status. json prints one event per line. State snapshots, state deltas, and the final result expose the run's context.

./my_agent run "Summarise README.md"
./my_agent run --format json "What is 2 + 2?"
./my_agent run --session-id 550e8400-e29b-41d4-a716-446655440000 "Continue"

serve

Available when the manifest enables http_server.

./my_agent serve [--no-migrations]

Start the HTTP server with its configured address and enabled interfaces.

Server address and request limits are configured through the http_server block.

On the initial shutdown signal, the server stops accepting new requests and work. Existing work has a thirty-second grace period to finish, after which remaining connections are forcibly closed.

migrate

./my_agent migrate

Apply pending migrations to the configured database and exit. This command explicitly runs migrations regardless of the automatic migration setting.

config

./my_agent config [--format human|json]

human prints the resolved configuration as debugging output with secret values redacted. json prints formatted JSON with secret values included. Treat JSON output as sensitive.

For loading and environment variable rules, see Runtime configuration.