Splat CLI for Codex and Claude
A practical operating manual for using AI agents to research markets, inspect accounts, preview Solana swaps, size Hyperliquid perps, and keep every signing action behind an explicit user confirmation.
splat --json doctor
$ splat --json doctor
{
"checks": {
"health": { "ok": true },
"scopes": { "ok": true },
"version": { "ok": true }
}
}
currentVersion === latestVersion gates trading sessions
1
live catalog
0
guessed flags
100%
confirmation
Copy-ready
Prompts people can paste straight into Codex or Claude.
These are written to keep agents in read-only mode unless the user gives a fresh signing confirmation.
Paste into Codex or Claude
Safe setup prompt
Use the Splat CLI to check my setup and list the current command surface. Do not trade, submit, revoke, claim, bridge, or change account state.
Research without execution
Trading prep prompt
Use the Splat CLI to research <TOKEN> and prepare a quote only. Show the exact preview math and command you would run next, but do not execute or submit anything.
Quickstart
Install the CLI, then install the agent guidance.
The CLI is the executable. The Codex and Claude guidance is the safety and operating layer that tells agents to inspect the live command surface before acting.
CLI install
brew install protastudios/tap/splat
splat --help
splat doctor
splat --json commandsAgent skills
npx @asksplat/agent-skills install
npx @asksplat/agent-skills install --codex
npx @asksplat/agent-skills install --claudeNo-npm fallback and restart
curl -fsSL https://raw.githubusercontent.com/protastudios/splat-cli-releases/main/install-agent-skills.sh | bash Restart Codex or Claude Code after install. Codex reads ~/.codex/skills/splat-cli/SKILL.md;
Claude reads ~/.claude/commands/splat.md and ~/.claude/SPLAT_CLAUDE.md.
Session checks
Start every agent session with cheap diagnostics.
These commands catch stale binaries, expired tokens, API failures, missing scopes, and PATH shadowing before an agent makes a recommendation.
Safety model
Inspection is easy. State changes are confirmation-gated.
Free to run
- account summary, risk, balances, portfolio, open-orders
- market search, token detail, candles, prices, watch
- portfolio solana-pnl
- solana tokens, pnl, trading-history, tx
- solana swap quote, quote-batch, preview, simulate
- orders perp size, preview, simulate
- orders builder-fee check
- user get, me, doctor, commands, auth status, api get, help
Confirm first
- execute, submit, confirm, send
- claim-* and withdraw-*
- transfers *
- orders perp open or close
- orders cancel
- orders builder-fee execute
- bridge create, send, withdraw-*
- *-revoke and auth logout
Command surface
The catalog agents should inspect, not memorize.
splat --json commands Group
Purpose
Auth
Risk
api Raw backend HTTP: GET, POST, PATCH, DELETE
varies
Escape hatch
account Balances, portfolio, risk, open orders
yes
Read-only
bridge Solana to Arbitrum to Hyperliquid moves
mixed
Moves funds
orders Perps, spot orders, TP/SL, builder fee, cancels
mixed
Moves funds
rewards Reward balances, staking APY, claims
mixed
Claims sign
solana Swap quotes, previews, submits, tokens, PnL, history
mixed
Execute signs
transfers Spot, perp, USDC, and spot asset transfers
yes
Moves funds
market Token detail, candles, price, transactions
yes
Read-only
portfolio Solana PnL graph
yes
Read-only
auth / api-tokens Login, status, logout, token management
varies
Revokes matter
oauth OAuth clients and token management
yes
Sensitive
me / doctor / commands Identity, health, live command discovery
varies
Read-only
Research playbook
Identify, quote, contextualize, decide.
Use the Solana-specific search for SPL mints, the Hyperliquid market search for perps, and token detail for authority, holder, liquidity, and volume checks.
Identify
splat solana tokens search <query> Use Solana search for SPL mints. It returns decimals, holder count, liquidity, launchpad data, creator, and rolling organic buy/sell stats.
Quote
splat solana swap quote <SOL_mint> <token_mint> <lamports> Use a quote to confirm a mint is routable and that input-side USD value matches your reference.
Contextualize
splat market tokens get SOLANA:<mint> Inspect authority status, supply, top holders, liquidity, 24h volume, and buy/sell pressure across time windows.
Decide
splat market candles get SOLANA:<mint> 1m,5m,1h,4h Summarize trend, range, volume, and key moving averages in text. Do not overfit the chart.
Solana swaps
Cost-first flow before any signature.
Amounts are raw input-token units. SOL has 9 decimals, so 0.005 SOL is 5000000.
USDC has 6 decimals, so 1.0 USDC is 1000000.
Recommended flow
- 1. Compare with
swap quote-batch. - 2. Preview the chosen route and inspect
costPreview. - 3. Simulate non-trivial routes with
--logs. - 4. Show output, USD value, route hops, price impact, and total SOL out.
- 5. Execute or submit only after explicit current-task confirmation.
- 6. Verify with
splat solana tx <signature>.
Command
Signs
Submits
Use when
swap quote No
No
Cheapest route and price check
swap quote-batch No
No
Compare candidates in one round trip
swap preview No
No
Last step before asking the user to sign
swap simulate No
No
Run RPC simulation and diagnose route or balance issues
swap execute Yes
Yes
Only after explicit current-task approval
Hyperliquid
Perp sizing flow
- 1
splat account risk - 2
splat orders perp size <asset> <riskPctOfAccount> <stopLossPrice> [--entry-price <n>] - 3
splat orders perp preview <assetIndex> <assetName> <price> <size> <isLong> [--market] - 4
splat orders perp simulate <assetIndex> <assetName> <price> <size> <isLong> [--market] - 5
splat orders perp execute ...
Run orders builder-fee check before trading. Builder-fee
approval is a signing action.
Bridge
Funding Hyperliquid
Bridge flows are slow, sign-heavy, and irreversible. The agent should not start one without explicit amount, source, destination, and confirmation.
splat bridge create <amount> [recipient] [sender]
splat bridge send <transaction> [userEvmAddress] <deadline> <signature> <balance> --payload-token <token>
splat bridge arbitrum-to-hyperliquid [userEvmAddress] <deadline> <signature> <balance>
splat bridge poll <userAddress>create, send, and arbitrum-to-hyperliquid default
the EVM address to your authenticated session's wallet when omitted, and reject an
explicit EVM address that doesn't match it before sending any request. create's Solana sender also defaults from your session when omitted, but an
explicit sender isn't checked against it — leave it out unless you mean to override it.
Gotchas
The problems agents should recognize before retrying.
Old binary shadowing
Run which -a splat. The first path wins. Re-check splat --version after upgrades.
market tokens search is HL-only
Use splat solana tokens search for Solana SPL discovery.
swapUsdValue is input-side
Compute output USD from outAmount, token decimals, and reference price.
ATA rent surprise
Use existingAta in quotes and costPreview in preview to see true total SOL out.
Default errors are not pure JSON
Use --json for programmatic agent flows.
Trading-history USD fields can move
Capture at-trade values from swap preview or solana tx.
account summary exclusions
Treat excluded[] as authoritative for spam or sanity-filtered tokens.
market tokens watch is price-only
Poll solana token stats if you need tape pressure.
Agent recipes
Prompts that map cleanly onto the CLI.
What can I afford to trade?
splat account summarysplat account risksplat account perp-balancesplat account spot-balancessplat solana tokenssplat account open-orders
Research a token for a small swap
splat solana tokens search <symbol>splat market tokens get SOLANA:<mint>splat solana swap quote SOL <mint> <size_in_lamports>splat solana swap preview ...
Did my trade go through?
splat solana tx <signature>splat solana tokenssplat solana trading-historyhttps://solscan.io/tx/<signature>
Watch SOL for a 1 percent move
splat market tokens watch <mint> --threshold-pct 1 --max-events 1
Default contract
The same rules apply to Codex and Claude.
Agents may research, summarize, quote, preview, and simulate. They may not sign, submit, bridge, claim, revoke, cancel, or otherwise change financial or account state without explicit current-task confirmation.
Last updated: May 14, 2026
Inspect before write.
Verify checks.version.ok from splat --json doctor at session start.
Prefer --json for programmatic calls.
Never invent flags or command names.
Preview before execute.
Simulate non-trivial routes with --logs.
Show amount, USD equivalent, route hops, and costPreview before signing.
Require one confirmation per signing action.
On failure, branch on exit code first, then data.simulation.success.
Verify after execute with solana tx, balances, and history.