SimpleFunctions CLI (`sf`)

Reference and issue mirror for @spfunctions/cli, the supported SimpleFunctions command-line interface for prediction-market infrastructure.

The current CLI is distributed through npm. Install the package and treat the installed sf binary as the source of truth:

npm i -g @spfunctions/cli
sf login
sf status --json
sf world --json
sf describe --all --json

sf is the primary local surface for SimpleFunctions. It queries live Kalshi + Polymarket state, inspects markets and orderbooks, exports structured JSON for coding agents, runs thesis and portfolio workflows, and keeps execution commands explicit and permission-gated.

What this repository is

Public reference page for the npm package.
Issue tracker for @spfunctions/cli.
Installation, support, and discovery pointer for the current sf surface.

What this repository is not

It is not the current full operator-runtime source tree.
It is not the canonical command inventory.
It should not be used to infer current command counts, market counts, or execution behavior.

Use sf describe --all --json for the installed command manifest. Use https://simplefunctions.dev/api/internal/statistics for current public surface counts.

First useful workflow

sf status --json
sf world --json
sf discover --quality --json
sf inspect <ticker> --json

If a command is unavailable in your installed version, run:

npm i -g @spfunctions/cli@latest
sf describe --all --json

Product surface order

CLI: primary local control plane for humans, shell scripts, cron, Claude Code, Codex, and other coding agents.
HTTP/Data API: network surface for services, dashboards, notebooks, and remote workers.
SDKs and agent runtime: planned wrappers over stable CLI/API object contracts.
MCP: compatibility adapter for MCP-only hosts, not the canonical product center.

License

The public mirror is MIT-licensed. The supported npm distribution may include private SimpleFunctions runtime code.