stellar-cli

An agent skill that gives Claude (and other AI agents) deep knowledge of the Stellar CLI v25.x — how to invoke contracts, simulate transactions, send payments, deploy contracts, manage keys/networks, and read on-chain data.

Install

npx skills add coderippr/stellar-cli-skill --all

Or install for a specific agent:

npx skills add coderippr/stellar-cli-skill --agent claude-code

What's Covered

• Contract simulation — read on-chain state without submitting transactions (--send no)
• Contract invocation — execute write operations with flexible signing options
• Transaction pipeline — build, sign, and send classic Stellar operations (tx new → tx sign → tx send)
• All 20+ classic operations — payments, trustlines, DEX offers, path payments, account merge, liquidity pools, claimable balances, sponsorships, and more
• Transaction simulation — simulate arbitrary XDR envelopes via tx simulate
• Transaction fetching — fetch by hash with result/meta/fee/events sub-commands
• Contract deployment — upload WASM, deploy instances, asset contracts, auto-build in Cargo workspaces
• Contract lifecycle — extend TTL, restore evicted entries
• Contract inspection — interface, metadata, fetch WASM, read storage, generate bindings
• Events — watch and filter contract/system events
• Key & network management — generate identities, configure networks, set defaults
• XDR operations — decode, encode, guess, compare
• Environment variables — full mapping of env vars to CLI flags
• Common mistakes — deprecated flags, stroop gotchas, --send no placement

Usage Examples

Once installed, your agent can simulate contract calls to compare on-chain state with indexer data:

# Simulate a DEX router quote (read-only, no secret key needed)
stellar contract invoke \
  --id CAG5LRYQ5JVEUI5TEID72EYOVX44TTUJT5BQR2J6J77FH65PCCFAJDDH \
  --source-account GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO \
  --network mainnet \
  --send no \
  -- router-quote --amount_a 10000000 --reserve_a 10000000000 --reserve_b 50000000000

Send XLM via the transaction pipeline:

stellar tx new payment \
  --source-account alice \
  --destination GDEST... \
  --asset native \
  --amount 10000000 \
  --network mainnet \
  --build-only \
  | stellar tx sign --sign-with-key alice --network mainnet \
  | stellar tx send --network mainnet

Deploy a Soroban contract:

stellar contract deploy \
  --wasm target/wasm32-unknown-unknown/release/my_contract.wasm \
  --source-account alice \
  --network testnet \
  --alias my-contract

Requirements

• Stellar CLI v25.x installed
• Networks configured via stellar network add

License

MIT