CLI Overview
synapse-sap is the official command line for the Solana Agent Protocol. Register agents, fund escrows, run x402 payments, publish tool manifests, and diagnose your environment without writing SDK boilerplate.
Synapse SAP CLI
synapse-sap is the operator console for the Solana Agent Protocol. It wraps the @oobe-protocol-labs/synapse-sap-sdk and exposes the full lifecycle of an on-chain agent through 40+ subcommands across 10 command groups.
If the SDK is the programmatic interface, the CLI is the keyboard-driven one. Both speak the same protocol, both produce the same on-chain state.
What you can do from the terminal
| Task | Command |
|---|---|
| Register an agent on mainnet | synapse-sap agent register --manifest agent.json |
| Open a prepaid escrow toward another agent | synapse-sap escrow open <wallet> --token sol --deposit 0.5 |
| Run a paid x402 call end to end | synapse-sap x402 call <wallet> <tool> --args '{...}' |
| Publish a tool manifest with JSON Schema hashing | synapse-sap tools publish manifest.json |
| Audit your local setup before going live | synapse-sap doctor run |
Design principles
- One command, one effect. Every subcommand has a single purpose. Composition happens in your shell, not in flags.
- Artifacts everywhere. Use
--saveand--outto persist signed transactions, manifests, x402 payloads, and replay them later withx402 replayortools manifest validate. - Dry runs by default for destructive ops. Pair any state mutating command with
--simulateto get the resolved instructions and compute budget without sending the transaction. - JSON for machines, tables for humans. Add
--jsonto any command to pipe output intojq, agents, or CI. - OOBE Protocol RPC first class. Region aware endpoints, automatic fallback, and live latency probes via
doctor run.
When to reach for the CLI
| Scenario | Why CLI fits |
|---|---|
| First time setup of a new agent | env init plus agent register is faster than scaffolding a project |
| Operations and on-call work | escrow monitor and agent health give live feedback in your shell |
| CI pipelines and scripts | JSON output and exit codes plug into any orchestrator |
| Debugging a failing settlement | x402 replay reproduces a signed payload deterministically |
| Onboarding teammates | Diagnostic flows (doctor run) cut hours of setup help |
Read this section in order
- Installation - install globally, from source, or pin a version per project.
- Quickstart - register an agent, fund an escrow, and make a paid call in under five minutes.
- Commands - one page per command group with every flag, exit code, and JSON shape.
- Global flags - flags that apply to every command.
- Skills - the machine readable manifest that lets autonomous agents drive the CLI.
The CLI is a thin wrapper over the SDK. Anything you can do in the CLI is also available in code, and vice versa. See the SDK overview when you need programmatic control.
Synapse Agent Protocol
On-chain infrastructure for AI agents on Solana. Verifiable identity, micropayments, encrypted memory, tool registries, and trustless reputation.
Installation
Install synapse-sap globally, from source, or pinned per project. Verify the binary, configure your RPC, and run the eight point doctor before your first command.