Skip to content

Latest commit

 

History

History
433 lines (276 loc) · 7.62 KB

cli-reference.md

File metadata and controls

433 lines (276 loc) · 7.62 KB

CLI Reference

Authoritative source: engine/cli/main.py (build_parser()).

All commands support --help.

Core

b1e55ed wizard

Interactive 5-step onboarding for new contributors. Recommended first command after install.

b1e55ed wizard

Covers: identity forge → config → producer registration → brain first run → API setup. From source: ./b1e55ed wizard or uv run b1e55ed wizard.

b1e55ed uninstall

Removes b1e55ed from the system. Prompts for confirmation unless --yes is given.

b1e55ed uninstall [--yes] [--keep-data]
Flag Description
--yes Skip confirmation prompts
--keep-data Preserve the data directory (brain DB, logs, config)

Alternatively, run the standalone script: ./uninstall.sh.

b1e55ed setup

Low-level setup. Writes config/user.yaml, initializes data/brain.db. The wizard calls this internally.

b1e55ed setup [--preset conservative|balanced|degen] [--non-interactive]

b1e55ed brain

Run one brain cycle.

b1e55ed brain [--full] [--json]

b1e55ed signal

Ingest operator intel as a curator signal.

b1e55ed signal "<text>" [--symbols "BTC,ETH"] [--source "operator"] [--direction bullish|bearish|neutral] [--conviction 0-10] [--json]

b1e55ed signal add --file <path> [--symbols ...] [--source ...] [--direction ...] [--conviction ...] [--json]

See: curator.md.

b1e55ed alerts

List recent alerts from the event store.

b1e55ed alerts [--since <minutes>] [--json]

b1e55ed positions

List open positions with best-effort mark price PnL.

b1e55ed positions [--json]

Analysis

b1e55ed kelly

Estimate optimal position sizing from trade history using the Kelly criterion. Regime-adjusted.

b1e55ed kelly [--json]

b1e55ed backtest walkforward

Walk-forward validation with FDR-corrected results.

b1e55ed backtest walkforward \
  [--symbols BTC,ETH,SOL] \
  [--strategies momentum,ma_crossover] \
  [--start 2023-01-01] \
  [--end 2025-12-31]

b1e55ed backtest gridsweep

Sweep parameter combinations for a strategy.

b1e55ed backtest gridsweep [--strategies momentum] [--assets BTC,ETH]

b1e55ed backtest megasweep

Sweep all strategies × all parameter combos × all assets. Runs in parallel.

b1e55ed backtest megasweep

b1e55ed backtest regime

Regime-conditioned backtest results.

b1e55ed backtest regime [--symbols BTC,ETH]

See: backtest.md.

b1e55ed report

Generate flywheel reports.

b1e55ed report --stratification [--json]
b1e55ed report --cockpit-summary [--json]
Flag Description
--stratification Confidence stratification report — compares high-confidence (≥0.65) vs low-confidence (<0.45) signal outcomes over 30 days
--cockpit-summary 7-day cockpit summary — top convictions, regime, kill switch state, recent P&L
--json Machine-readable JSON output

System

b1e55ed health

Cron-safe health check.

b1e55ed health [--json]

b1e55ed status

System status summary.

b1e55ed status

b1e55ed integrity

Verify hash chain integrity over the event store.

b1e55ed integrity [--json]

b1e55ed replay

Rebuild projections from the event log. Use after manual DB repair or to verify event store consistency.

b1e55ed replay

Identity and Keys

b1e55ed identity forge

Forge a 0xb1e55ed-prefixed Ethereum identity. Required for EAS attestations.

b1e55ed identity forge [--threads N] [--json]

b1e55ed identity show

Show the currently forged identity.

b1e55ed identity show [--json]

b1e55ed identity restore

Recover a lost identity from an Ethereum private key. The Ed25519 signing key is deterministically derived via HKDF — no backup file needed.

b1e55ed identity restore --eth-key <hex-private-key>

See Identity recovery for the full procedure.

b1e55ed keys list

b1e55ed keys list [--json]

b1e55ed keys set

b1e55ed keys set <name> <value> [--json]

b1e55ed keys remove

b1e55ed keys remove <name> [--json]

b1e55ed keys test

b1e55ed keys test [--json]

b1e55ed anchor

Print the current hash-chain root. Optionally publish as an EAS attestation.

b1e55ed anchor [--format json|text] [--eas]

b1e55ed export karma

Export karma data from the event store.

b1e55ed export karma \
  [--format jsonl|json|csv] \
  [--include-chain] \
  [--output <path>] \
  [--from DATE] \
  [--to DATE]

Producers

b1e55ed producers register

b1e55ed producers register \
  --name <name> \
  --domain <domain> \
  --endpoint <url> \
  [--schedule "*/15 * * * *"]

b1e55ed producers list

b1e55ed producers list [--json]

b1e55ed producers remove

b1e55ed producers remove --name <name>

Contributors

b1e55ed contributors register

b1e55ed contributors register \
  --name <name> \
  --role operator|agent|tester|curator \
  [--node-id <node_id>] \
  [--attest]

b1e55ed contributors list

b1e55ed contributors list [--json]

b1e55ed contributors remove

b1e55ed contributors remove --id <contributor_id>

b1e55ed contributors score

b1e55ed contributors score --id <contributor_id> [--json]

b1e55ed contributors leaderboard

b1e55ed contributors leaderboard [--limit N] [--json]

See: contributors.md.

Webhooks

Webhook subscriptions are stored in the local database.

b1e55ed webhooks add

b1e55ed webhooks add <url> --events "alert.*,system.kill_switch.*"

b1e55ed webhooks list

b1e55ed webhooks list [--json]

b1e55ed webhooks remove

b1e55ed webhooks remove <id>

Services

b1e55ed daemon

Start all subsystems as a supervised process group. Recommended for production — manages API, dashboard, brain cycles, and outcome resolution with automatic restart.

b1e55ed daemon [--status]
  • --status — show daemon status and exit without starting

b1e55ed start

Start API + dashboard together. Recommended entry point — opens browser automatically.

b1e55ed start [--api-port <port>] [--dashboard-port <port>] [--host <host>] [--no-browser]

Defaults: API on 5050, dashboard on 5051, host 127.0.0.1. Press Ctrl+C to stop both.

b1e55ed api

Start the REST API server (standalone).

b1e55ed api [--host <host>] [--port <port>]

Default: http://127.0.0.1:5050

b1e55ed dashboard

Start the dashboard (standalone).

b1e55ed dashboard [--host <host>] [--port <port>]

Default: http://127.0.0.1:5051

Integrations

b1e55ed eas status

b1e55ed eas status [--json]

b1e55ed eas verify

b1e55ed eas verify --uid <uid> [--json]

See: eas-integration.md.

b1e55ed kill-switch

Show current kill switch level.

b1e55ed kill-switch [--json]

b1e55ed kill-switch set

Set the kill switch level (0 = off, 1–4 = escalating restriction).

b1e55ed kill-switch set <level 0-4> [--json]

b1e55ed resolve-outcomes

Resolve elapsed FORECAST_V1 events against actual prices. Writes FORECAST_OUTCOME_V1 events (immutable). Idempotent — safe to run every 30 minutes via cron.

b1e55ed resolve-outcomes

Returns: count of forecasts resolved in this run. Exit 0 always.