> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gensparx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# agent

# `gensparx agent`

Run an agent turn via the Gateway (use `--local` for embedded).
Use `--agent <id>` to target a configured agent directly.

Related:

* Agent send tool: [Agent send](/tools/agent-send)

## Examples

```bash theme={null}
gensparx agent --to +15555550123 --message "status update" --deliver
gensparx agent --agent ops --message "Summarize logs"
gensparx agent --session-id 1234 --message "Summarize inbox" --thinking medium
gensparx agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
```