Skip to content

SoftProbe CLI`sp` — record/replay testing from the command line

Setup, create an app, list it, set recording policy, run the app with the Java agent, list recorded cases, set replay policy, replay, and inspect results.

What is sp?

sp is the SoftProbe command-line interface. SoftProbe records real traffic from Java services through a -javaagent, stores those cases, then replays them later with automatic dependency mocking and response comparison.

It is designed primarily for AI agents that automate app setup, policy changes, recording verification, replay diagnosis, and CI gates. Humans and shell scripts use the same commands.

All public commands are HTTP clients to sp-boot (default http://127.0.0.1:8090). The Java agent separately talks to backend services to pull config, send heartbeats, and upload recording/replay data.

Command areas

AreaCommands
Platformconfig, auth, app, policy, replay, health
Investigationrecord, trace, replay case/diff, extraction-rule
Administrationgroup, system, ops

See Commands overview.

  • Policy YAML guide — schema and examples for recording, mock, and compare policies
  • spcode / @spcode/plugin — OpenCode integration; migrates from sp_api endpoints to sp subcommands

Zero code changes · Full-context visibility · Cost optimization