Public agent guide

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 commands

Agent skills

npx @asksplat/agent-skills install
npx @asksplat/agent-skills install --codex
npx @asksplat/agent-skills install --claude

No-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.

1

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.

2

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.

3

Contextualize

splat market tokens get SOLANA:<mint>

Inspect authority status, supply, top holders, liquidity, 24h volume, and buy/sell pressure across time windows.

4

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. 1. Compare with swap quote-batch.
  2. 2. Preview the chosen route and inspect costPreview.
  3. 3. Simulate non-trivial routes with --logs.
  4. 4. Show output, USD value, route hops, price impact, and total SOL out.
  5. 5. Execute or submit only after explicit current-task confirmation.
  6. 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. 1 splat account risk
  2. 2 splat orders perp size <asset> <riskPctOfAccount> <stopLossPrice> [--entry-price <n>]
  3. 3 splat orders perp preview <assetIndex> <assetName> <price> <size> <isLong> [--market]
  4. 4 splat orders perp simulate <assetIndex> <assetName> <price> <size> <isLong> [--market]
  5. 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.

All recipes are read-only until the user confirms a signing command.

What can I afford to trade?

  • splat account summary
  • splat account risk
  • splat account perp-balance
  • splat account spot-balances
  • splat solana tokens
  • splat 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 tokens
  • splat solana trading-history
  • https://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

1

Inspect before write.

2

Verify checks.version.ok from splat --json doctor at session start.

3

Prefer --json for programmatic calls.

4

Never invent flags or command names.

5

Preview before execute.

6

Simulate non-trivial routes with --logs.

7

Show amount, USD equivalent, route hops, and costPreview before signing.

8

Require one confirmation per signing action.

9

On failure, branch on exit code first, then data.simulation.success.

10

Verify after execute with solana tx, balances, and history.