pi sparklesfinance kit

Manual · commands

Operator commands stay exact.

These slash commands are registered by the 0.1.5 all-in-one package. They inspect, switch, or queue work. None of them place, route, cancel, or replace an order.

Slash commands17
Launch flags3
Trackscn · hk · us
Order mutationNone

Statusline

Navigation telemetry, not a verdict.

The TUI statusline keeps the active track visible. Use the structured finance_track_status receipt — denominator, criteria, gaps — before treating the compact percentages as operationally credible.

CN · CNY · Asia/Shanghai · src:65% · feat:100%
track

track

The active navigation context: CN, HK, or US. It does not rewrite source evidence.

src

src

Equal-weight evidence-maturity of the track's versioned source stack. Verified is 100%, partial 50%, missing 0%. It is not the probability that a source statement is true. A critical criterion must still be fully verified.

feat

feat

Installed end-user feature coverage for the active track only. A US tool never increases CN or HK coverage. Breadth is not data completeness.

agent

agent

Whether AGENT_CONTACT is configured. The value itself is never shown to the model or written to the session log.

The version-1 feature denominator has ten equally weighted families. Installed breadth is not statement depth, entitlement, or source-maturity parity:

navigation contextsource registrysecurity identitymarket calendareffective rulesquotes and historydisclosure discoveryraw fundamentalsnormalized fundamentalsreproducible derivations

Launch flags

Defaults are interaction defaults.

FlagValuesMeaning
--finance-trackcn | hk | us

Initial navigation track. Invalid values fail safe to us. This is navigation only.

--finance-currencyISO currency, default USD

Global reporting default for /finance-setup. It is not the active track currency.

--finance-timezoneUTC or IANA Area/Location, default UTC

Global reporting default for /finance-setup. It is not the active track timezone.

pi --finance-track=cn
# equivalent once Pi is running
/finance-track cn

Slash surface

Show, switch, or queue — never execute.

CommandPluginWhat it does
/finance-setup/finance-setup
finance_setup

Inspect installed foundations, reporting defaults, and whether a named adapter surface is present. It never prints secrets or claims live connectivity.

/finance-track/finance-track [cn|hk|us]
finance_track_status

Show the active navigation track, or switch it. Switching never relabels observations, providers, calendars, or persisted state.

/cn-track/cn-track
finance_track_status

Direct shortcut to the mainland China navigation track.

/hk-track/hk-track
finance_track_status

Direct shortcut to the Hong Kong navigation track.

/us-track/us-track
finance_track_status

Direct shortcut to the United States navigation track.

/cn-setup/cn-setup
cn_setup

Inspect isolated mainland capabilities and blocked provider decisions. Companion tools advance only their own surfaces.

/cn-sources/cn-sources
cn_setup

Show verified mainland authorities, official roles, access state, and redistribution limits.

/hk-setup/hk-setup
hk_setup

Inspect isolated Hong Kong capabilities and blocked provider decisions.

/hk-sources/hk-sources
hk_setup

Show verified Hong Kong authorities, including HKEXnews and HKEX Full List roles.

/finance-policy/finance-policy
finance_guardrails

Show the active evidence policy: freshness, provenance, disclaimer, and incompatible-mix rejection.

/symbol/symbol <query>
finance_symbols

Resolve a name or ticker through OpenFIGI v3. Ambiguity is returned, never guessed.

/sec-company/sec-company <ticker or company name>
sec_edgar

Search the SEC ticker association file without guessing a CIK.

/us-research/us-research <company, symbol, CIK, period>
stock_research_report

Queue a bounded US source-fact brief workflow from already-named receipts.

/fundamentals/fundamentals
stock_fundamentals

Show the US fundamentals workflow and the exact supported metric definitions.

/swing/swing [workflow-name]
swing_workbench

Show exact branch-scoped swing workflow facts without selecting a next step.

/journal/journal <local-jsonl-path>
trade_journal

Show compact journal context from an explicit local JSONL path. Decisions stay with the LLM.

/watch/watch [list-name]
watchlist

Show saved watchlists or one exact lowercase list name. Members stay on their labelled track.

Typical first minute

Inventory, then choose a track.

Try this in Pi
›

Run the finance setup and track-status tools. Do not reveal environment values. Tell me which of CN, HK, and US have configured read-only adapters, then wait for me to choose a track and a provider.