Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@spfunctions/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
SimpleFunctions CLI (sf)
Prediction market thesis agent CLI. Pure HTTP client — no project dependencies.
Install
npm install -g @spfunctions/cliConfiguration
export SF_API_KEY=sf_live_xxx # required
export SF_API_URL=https://simplefunctions.dev # optional, defaults to productionOr pass inline:
sf --api-key sf_live_xxx listCommands
sf list
List all theses.
ID Status Conf Updated Title
f582bf76 active 82% Mar 12 11:13 Trump cannot exit the Iran war...sf get <id>
Full thesis details: causal tree, edge analysis, positions, last evaluation.
sf get f582bf76
sf get f582bf76 --jsonsf context <id>
Primary command for agents. Returns a compact context snapshot: thesis, confidence, causal tree nodes, top edges, positions, last evaluation summary.
sf context f582bf76
sf context f582bf76 --json # machine-readable for agent parsingsf create "thesis text"
Create a new thesis. Sync by default (waits for formation agent to complete).
sf create "Trump cannot exit the Iran war gracefully before 2027"
sf create "..." --async # return immediatelysf signal <id> "content"
Inject a signal into the thesis queue. Queued for next monitor cycle.
sf signal f582bf76 "Oil closes at $95 today"
sf signal f582bf76 "Iran closes Strait of Hormuz" --type news
sf signal f582bf76 "My read: escalation likely" --type user_noteSignal types: news | user_note | external (default: user_note)
sf evaluate <id>
Trigger a deep evaluation using the heavy model (Claude Opus).
sf evaluate f582bf76sf scan "keywords"
Explore Kalshi markets directly (no auth required).
sf scan "oil recession iran"
sf scan --series KXWTIMAX
sf scan --market KXWTIMAX-26DEC31-T140
sf scan "oil" --jsonFor AI Agents (OpenClaw etc.)
After npm install -g simplefunctions and setting SF_API_KEY:
You can use the sf CLI to interact with SimpleFunctions:
- sf context <id> --json Get current thesis state (JSON)
- sf signal <id> "content" Inject an observation note
- sf list List all theses
- sf scan "keywords" Explore Kalshi marketsAgents should call sf context <id> --json periodically to get the latest state, then decide whether to inject signals or alert the user.
Local Development
cd cli
npm install
npm run dev -- list # run without building
npm run build # compile to dist/
npm link # install as global 'sf' command
sf list