CLI Reference - b1e55ed

All commands support --help. For the full authoritative source, see engine/cli/main.py (build_parser()).

Conventions

Examples assume b1e55ed is on your PATH.
Many commands support --json for machine-readable output.

Core (day-to-day)

`b1e55ed wizard`

Interactive 5-step onboarding for new contributors/operators.

b1e55ed wizard

Identity forge

Creates a 0xb1e55ed-prefixed Ethereum identity used for EAS/network-facing integrations.

Config

Writes config/user.yaml (and initializes local state).

Producer registration

Registers and schedules producers.

Brain first run

Runs an initial cycle to verify ingestion → synthesis → storage.

API setup

Helps you set API auth and verify health.

`b1e55ed setup`

Low-level setup. Initializes local DB and writes config. (The wizard calls this internally.)

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

Flag	Description
`--preset`	Applies a preset overlay before writing `config/user.yaml`
`--non-interactive`	Avoid prompts (best for scripts)

`b1e55ed brain`

Run one brain cycle.

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

Flag	Description
`--full`	Include slower producers / more expensive work
`--json`	Emit JSON summary (cron/automation friendly)

`b1e55ed signal`

Inject operator intel as a curator signal.

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

Add from a file:

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

Flag	Description
`--symbols`	Comma-separated symbols to associate with the signal
`--source`	Freeform provenance (e.g. `operator:telegram`)
`--direction`	`bullish`, `bearish`, or `neutral`
`--conviction`	0–10 (used for calibration / scoring)
`--json`	Print JSON output

`b1e55ed alerts`

List recent alerts from the event store.

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

Flag	Description
`--since`	Look back window in minutes
`--json`	JSON output

`b1e55ed positions`

List open positions with best-effort mark price PnL.

b1e55ed positions --help
b1e55ed positions [--json]

System

`b1e55ed health`

Cron-safe health check.

b1e55ed health --help
b1e55ed health [--json]

`b1e55ed status`

Human-readable system status summary.

b1e55ed status

`b1e55ed integrity`

Verify hash-chain integrity over the event store.

b1e55ed integrity --help
b1e55ed integrity [--json]

`b1e55ed replay`

Rebuild projections from the event log (useful after DB repair or when validating consistency).

b1e55ed replay

Services (API + dashboard)

`b1e55ed start`

Start API + dashboard together (recommended entry point).

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

Flag	Description
`--api-port`	API port (default `5050`)
`--dashboard-port`	Dashboard port (default `5051`)
`--host`	Bind host (default `127.0.0.1`)
`--no-browser`	Don’t auto-open a browser

`b1e55ed api`

Start the REST API server only.

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

`b1e55ed dashboard`

Start the dashboard only.

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

Identity and keys

`b1e55ed identity forge`

Forge a 0xb1e55ed-prefixed Ethereum identity (CPU-bound).

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

Flag	Description
`--threads`	Parallelism for the forge search
`--json`	JSON output

`b1e55ed identity show`

Show your currently forged identity.

b1e55ed identity show [--json]

`b1e55ed identity restore`

Recover identity from an Ethereum private key.

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

`b1e55ed keys`

Manage stored keys/values.

b1e55ed keys list [--json]
b1e55ed keys set <name> <value> [--json]
b1e55ed keys remove <name> [--json]
b1e55ed keys test [--json]

`b1e55ed anchor`

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

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

Flag	Description
`--format`	Output format
`--eas`	Publish as EAS attestation (requires EAS configured)

Producers

`b1e55ed producers register`

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

Flag	Description
`--name`	Producer name / identifier
`--domain`	One of: `curator`, `onchain`, `tradfi`, `social`, `technical`, `events`
`--endpoint`	URL the producer polls
`--schedule`	Cron string for polling cadence

`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]

Flag	Description
`--name`	Display name
`--role`	Contributor role
`--node-id`	Override detected node id
`--attest`	Create/store an EAS off-chain attestation (optional)

`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]

Kill switch

`b1e55ed kill-switch`

Show current kill switch level.

b1e55ed kill-switch [--json]

`b1e55ed kill-switch set`

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

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

Export

`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]

Flag	Description
`--format`	Output format
`--include-chain`	Include hash-chain data alongside exports
`--output`	Write to a file instead of stdout
`--from` / `--to`	Optional date bounds

Analysis commands

`b1e55ed kelly`

Estimate optimal position sizing from trade history (Kelly criterion).

b1e55ed kelly [--json]

`b1e55ed backtest`

Walk-forward:

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

Grid sweep:

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

Mega sweep:

b1e55ed backtest megasweep

Regime-conditioned results:

b1e55ed backtest regime [--symbols BTC,ETH]

Webhooks

`b1e55ed webhooks`

Webhook subscriptions are stored in the local database.

b1e55ed webhooks add <url> --events "alert.*,system.kill_switch.*"
b1e55ed webhooks list [--json]
b1e55ed webhooks remove <id>

EAS integration

`b1e55ed eas`

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

EAS is optional and disabled by default. See the config reference for eas.* keys.

Uninstall

`b1e55ed daemon`

Run b1e55ed as a background daemon (brain cycles + resolver + retention on schedule).

b1e55ed daemon

Intervals are configured via daemon.* in config/user.yaml. The daemon is started automatically by b1e55ed start.

`b1e55ed report`

Generate a performance report with stratification by confidence band.

b1e55ed report [--stratification] [--json]

`b1e55ed monitor-positions`

Evaluate stop-loss, take-profit, and time-based stops for all open paper positions. Runs automatically on every daemon cycle; can also be invoked manually.

b1e55ed monitor-positions [--json]

`b1e55ed prune`

Prune old events and data according to the configured retention policy.

b1e55ed prune [--dry-run]

`b1e55ed register`

Register this node on the ERC-8004 Identity Registry. Mints an agent NFT linking the oracle to its on-chain identity. Requires onchain.enabled: true and a funded wallet configured in onchain.private_key.

b1e55ed register [--json]

`b1e55ed reconcile`

Backfill missing execution provenance events. Safe to run multiple times.

b1e55ed reconcile [--dry-run]

`b1e55ed resolve-outcomes`

Resolve elapsed FORECAST_V1 events into FORECAST_OUTCOME_V1 scored records.

b1e55ed resolve-outcomes [--dry-run]

`b1e55ed resolve-spi`

Resolve expired SPI signals against real market outcomes. Updates producer karma.

b1e55ed resolve-spi [--json]

Automatically run by the daemon every 30 minutes via resolve-outcomes. Use this command to trigger SPI resolution manually.

`b1e55ed spi`

SPI signal producer management (register, status, promote, test-key).

b1e55ed spi register --name <name> --domain <domain>
b1e55ed spi status --id <producer-id>
b1e55ed spi promote --id <producer-id>
b1e55ed spi test-key --id <producer-id>

See External Producers for the full SPI guide.

`b1e55ed verify-chain`

Verify the full event hash chain (alias for integrity --no-fast).

b1e55ed verify-chain [--json]

`b1e55ed uninstall`

Removes b1e55ed from the system. Prompts unless --yes is provided.

b1e55ed uninstall [--yes] [--keep-data]

Flag	Description
`--yes`	Skip confirmation prompts
`--keep-data`	Preserve local data directory (DB, logs, config)

Getting Started

Setup

Producers

Operations

Features

Integrations

API Reference

Contributing

Reference

​Conventions

​Core (day-to-day)

​b1e55ed wizard

​b1e55ed setup

​b1e55ed brain

​b1e55ed signal

​b1e55ed alerts

​b1e55ed positions

​System

​b1e55ed health

​b1e55ed status

​b1e55ed integrity

​b1e55ed replay

​Services (API + dashboard)

​b1e55ed start

​b1e55ed api

​b1e55ed dashboard

​Identity and keys

​b1e55ed identity forge

​b1e55ed identity show

​b1e55ed identity restore

​b1e55ed keys

​b1e55ed anchor

​Producers

​b1e55ed producers register

​b1e55ed producers list

​b1e55ed producers remove

​Contributors

​b1e55ed contributors register

​b1e55ed contributors list

​b1e55ed contributors remove

​b1e55ed contributors score

​b1e55ed contributors leaderboard

​Kill switch

​b1e55ed kill-switch

​b1e55ed kill-switch set

​Export

​b1e55ed export karma

​b1e55ed kelly

​b1e55ed backtest

​b1e55ed webhooks

​b1e55ed eas

​Uninstall

​b1e55ed daemon

​b1e55ed report

​b1e55ed monitor-positions

​b1e55ed prune

​b1e55ed register

​b1e55ed reconcile

​b1e55ed resolve-outcomes

​b1e55ed resolve-spi

​b1e55ed spi

​b1e55ed verify-chain

​b1e55ed uninstall

Conventions

Core (day-to-day)

`b1e55ed wizard`

`b1e55ed setup`

`b1e55ed brain`

`b1e55ed signal`

`b1e55ed alerts`

`b1e55ed positions`

System

`b1e55ed health`

`b1e55ed status`

`b1e55ed integrity`

`b1e55ed replay`

Services (API + dashboard)

`b1e55ed start`

`b1e55ed api`

`b1e55ed dashboard`

Identity and keys

`b1e55ed identity forge`

`b1e55ed identity show`

`b1e55ed identity restore`

`b1e55ed keys`

`b1e55ed anchor`

Producers

`b1e55ed producers register`

`b1e55ed producers list`

`b1e55ed producers remove`

Contributors

`b1e55ed contributors register`

`b1e55ed contributors list`

`b1e55ed contributors remove`

`b1e55ed contributors score`

`b1e55ed contributors leaderboard`

Kill switch

`b1e55ed kill-switch`

`b1e55ed kill-switch set`

Export

`b1e55ed export karma`

`b1e55ed kelly`

`b1e55ed backtest`

`b1e55ed webhooks`

`b1e55ed eas`

Uninstall

`b1e55ed daemon`

`b1e55ed report`

`b1e55ed monitor-positions`

`b1e55ed prune`

`b1e55ed register`

`b1e55ed reconcile`

`b1e55ed resolve-outcomes`

`b1e55ed resolve-spi`

`b1e55ed spi`

`b1e55ed verify-chain`

`b1e55ed uninstall`