Roadmap: agent-cli v1 #43

Roadmap for agent-cli: thin, agent-native Hyperliquid trading CLI + SKILL.md.

Locked decisions: hybrid custody (approveAgent once, Privy-managed agent, trade-only policy), thin CLI, persistent runner, normalized errors.

Core CLI

• Scaffold TypeScript project: build, lint, test, CI #1 Scaffold TypeScript project: build, lint, test, CI
• CLI framework: JSON in / JSON out, global flags, exit codes #4 CLI framework: JSON in / JSON out, global flags, exit codes
• Config file ~/.bloxwap/config.json with schema, migrations and config command #5 Config file ~/.bloxwap/config.json with schema, migrations and config command
• Hyperliquid client wrapper around @bloxwap/hyperliquid #7 Hyperliquid client wrapper around @bloxwap/hyperliquid

Persistent Runner

• ADR: choose runner command interface (stdin JSON-RPC vs local HTTP vs Unix socket) #2 ADR: choose runner command interface (stdin JSON-RPC vs local HTTP vs Unix socket)
• run command: persistent runner process lifecycle #26 run command: persistent runner process lifecycle
• Runner command interface (per ADR) and client routing #27 Runner command interface (per ADR) and client routing
• Hyperliquid WebSocket subscriptions with reconnect #28 Hyperliquid WebSocket subscriptions with reconnect
• JSON-line event stream and events command #29 JSON-line event stream and events command
• logs command #30 logs command
• Runner health, heartbeat and state reporting #31 Runner health, heartbeat and state reporting

Error Handling

• Normalized error model and error code catalog #3 Normalized error model and error code catalog
• Map Hyperliquid, Privy and Relay errors to normalized codes #8 Map Hyperliquid, Privy and Relay errors to normalized codes
• Retry/backoff policy and nonce management #9 Retry/backoff policy and nonce management

Security & Observability

• Structured logging (JSON lines, levels, redaction) #6 Structured logging (JSON lines, levels, redaction)
• Local pre-trade risk limit checks #21 Local pre-trade risk limit checks
• Audit trail: intent → decision → signature → fill #35 Audit trail: intent → decision → signature → fill
• Secret handling and master-key safety #36 Secret handling and master-key safety
• Testnet end-to-end test suite #39 Testnet end-to-end test suite

Wallet & Custody

• Privy server wallet + authorization key integration #10 Privy server wallet + authorization key integration
• Privy wallet policies: trade-only, never withdraw #11 Privy wallet policies: trade-only, never withdraw
• init command: Privy wallet, agent key, one-time approveAgent #12 init command: Privy wallet, agent key, one-time approveAgent
• Agent expiry detection and warnings #32 Agent expiry detection and warnings
• rotate command: new agent key with zero-downtime handoff #33 rotate command: new agent key with zero-downtime handoff
• revoke command #34 revoke command

Funding

• Builder code / builder fee configuration #13 Builder code / builder fee configuration
• Relay quote client for HyperCore deposit addresses #14 Relay quote client for HyperCore deposit addresses
• USDC decimal conversion: 6 (EVM) vs 8 (HyperCore perps) #15 USDC decimal conversion: 6 (EVM) vs 8 (HyperCore perps)
• Terminal QR rendering #16 Terminal QR rendering
• fund command: deposit address, QR, min deposit and fee transparency #17 fund command: deposit address, QR, min deposit and fee transparency
• Two-step Hyperliquid deposit signature flow #18 Two-step Hyperliquid deposit signature flow
• Deposit status tracking (status polling + DEPOSIT_PENDING) #19 Deposit status tracking (status polling + DEPOSIT_PENDING)

Trading Commands

• status, balance, positions, orders commands #20 status, balance, positions, orders commands
• order command (limit, market/IOC, reduce-only, TP/SL) #22 order command (limit, market/IOC, reduce-only, TP/SL)
• cancel command (by oid, cloid, coin, or all) #23 cancel command (by oid, cloid, coin, or all)
• modify command #24 modify command
• leverage command (cross/isolated) #25 leverage command (cross/isolated)

Skill & Docs

• SKILL.md for Claude Code / Codex #37 SKILL.md for Claude Code / Codex
• README, command reference and docs site #38 README, command reference and docs site

Packaging

• Global install: npm i -g and Bun #40 Global install: npm i -g and Bun
• Release pipeline (changesets, npm publish, binaries, provenance) #41 Release pipeline (changesets, npm publish, binaries, provenance)
• Distribute SKILL.md with the package #42 Distribute SKILL.md with the package