`bullpen status`¶

Last updated: August 26, 2026

Show passive local CLI, credential, and cached account status without network checks

Usage¶

bullpen status [OPTIONS]

Live Help¶

Show passive local CLI, credential, and cached account status without network checks

Usage: bullpen status [OPTIONS]

Options:
      --no-split-brain-warning
          Compatibility flag retained for scripts. Passive status does not check every wallet for assets outside the selected trading wallet

      --output <OUTPUT>
          Output format for command results

          [possible values: table, json]

      --env <ENV>
          Target environment to connect to (overrides config.toml)

          [env: BULLPEN_ENV=]
          [possible values: staging, production]

      --config <CONFIG>
          Path to a custom config.toml file (overrides $BULLPEN_CONFIG and the default location).

          Explicit --config and BULLPEN_CONFIG paths fail closed: if the file is missing, the CLI exits validation instead of silently loading defaults. Credentials still resolve via BULLPEN_HOME, so set BULLPEN_HOME too when isolating a session.

      --read-only
          Enable read-only mode: blocks all mutating commands

      --non-interactive
          Suppress interactive prompts; does NOT imply --yes for money-moving commands

          [env: BULLPEN_NON_INTERACTIVE=]

  -h, --help
          Print help (see a summary with '-h')

EXAMPLES:
  # Show local-only status without refreshing remote evidence
  bullpen status

  # Export status as JSON
  bullpen status --output json

  # Refresh wallet, asset-location, and order credit evidence
  bullpen polymarket wallet-audit --refresh --include-order-credit --output json

  # Run active account recovery checks
  bullpen fix --refresh

Example Commands¶

State change: Start with passive status. Run a refresh or recovery command only when the preceding output recommends it.

bullpen status
bullpen status --output json
bullpen polymarket wallet-audit --refresh --include-order-credit --output json
bullpen fix --refresh

JSON Output¶

Contract: JSON Output Contract.

Successful output is a single JSON document. The shape below is representative for this command family; commands may add fields without breaking the shared contract.

Schema version: 1 when a command emits schema_version; otherwise treat the current command shape as contract version 1.

Top-level Keys¶

key	type	nullable	notes
`version`	string	no	CLI version and channel label
`environment`	string	no	Active Bullpen environment after config and flags
`credentials`	string	no	Credential-store description; secrets are never printed
`credential_storage`	object	no	Support-safe credential-store backend and file-presence summary
`session_recovery`	object or null	yes	Support-safe login/session recovery state, or null when no recovery action is required
`auth_session_state`	string	no	Effective local auth-session state used by both the root envelope and health summary
`auth_session_recoverable`	boolean	no	Whether the current auth session can recover without a new login
`update_check`	object	no	Passive update-check state and the explicit command for checking releases
`account`	object	no	Login state and token-store backend summary
`health`	object	no	Auth, token, wallet-kind, and Polymarket order-readiness summary; current output includes nested `schema_version: 2`
`trading_access`	object	no	Bullpen trading routing, signer-source, and wallet-kind context
`trade_auth_state`	string	no	Normalized trade-auth state, such as `ready` or `reauthentication_required`
`trade_auth_blocked`	boolean	no	Whether trade submission should be considered blocked
`trade_auth_diagnostic_note`	string	no	Canonical note that passive status does not perform active auth checks
`pending_actions`	array	no	Support-safe remediation actions the user should complete
`polymarket`	object	no	Polymarket status-page summary and component health
`polymarket_wallet_evidence`	object	no	Read-only wallet-routing evidence or unavailable reason
`prediction_trading_readiness`	object	no	Normalized prediction-trading readiness and next action
`remediation`	object	yes	Next recommended command and explanation when auth or routing blocks trading
`skills`	array	no	Installed Bullpen skill freshness summary
`solana`	object	no	Experimental Solana configuration and wallet summary
`support`	object	no	Documentation, issue, and support-ticket URLs
`community`	object	no	Bullpen community links
`update_available`	object	yes	Available CLI update metadata when a newer release is detected

Example¶

Example JSON output

bullpen status --output json

{
  "account": {
    "logged_in": false,
    "profile_next_command": "bullpen doctor auth --output json",
    "profile_status": "not_checked",
    "requires_login": true,
    "status": "not_logged_in",
    "token_store": "file",
    "turnkey_bundle_next_command": "bullpen doctor auth --output json",
    "turnkey_bundle_status": "not_checked"
  },
  "community": {
    "discord": "https://discord.com/invite/bullpen",
    "x": "https://x.com/BullpenFi"
  },
  "auth_session_recoverable": false,
  "auth_session_state": "login_required",
  "credentials": "file",
  "credential_storage": {
    "backend": "file",
    "credentials_lock_present": false,
    "encrypted_credentials_present": false,
    "format": "none",
    "plaintext_credentials_present": false
  },
  "environment": "production",
  "health": {
    "clob_api_key_present": null,
    "clob_readiness_next_command": "bullpen polymarket wallet-audit --refresh --include-order-credit --output json",
    "clob_readiness_status": "not_checked",
    "email": null,
    "logged_in": false,
    "polymarket_address": null,
    "schema_version": 2,
    "token_expires_in_seconds": null,
    "token_refreshable": false,
    "token_status": "login_required",
    "token_timing": null,
    "token_valid": false,
    "wallet_kind": null
  },
  "multi_wallet": null,
  "pending_actions": [],
  "polymarket": {
    "components": [],
    "detail": "Passive status does not contact the Polymarket status service.",
    "next_command": "bullpen polymarket status --output json",
    "status": "not_checked",
    "status_url": "https://status.polymarket.com"
  },
  "polymarket_routing_warning": null,
  "polymarket_wallet_evidence": {
    "detail": "Passive status does not contact wallet, CLOB, relayer, or order-credit services.",
    "reason": "passive_status_local_only",
    "source_command": "bullpen polymarket wallet-audit --refresh --include-order-credit --output json",
    "status": "not_checked"
  },
  "prediction_trading_readiness": {
    "detail": "Login is required before trading can be checked.",
    "external_relayer_registration_checked": false,
    "external_relayer_registration_evidence_source": null,
    "external_relayer_registration_status": "unknown",
    "label": "Action needed",
    "next_command": "bullpen login",
    "resolution_owner": "user",
    "safe_to_retry": false,
    "status": "action_needed",
    "terminal": false
  },
  "session_recovery": {
    "code": "auth_login_required",
    "next_command": "bullpen login",
    "requires_login": true,
    "safe_to_retry": false,
    "state": "login_required"
  },
  "remediation": {
    "action": "retry_diagnostic",
    "command": "bullpen doctor auth --output json",
    "message": "Passive status does not contact Bullpen or Turnkey auth services. Run the diagnostic command to validate active trade authentication."
  },
  "skills": [
    {
      "name": "bullpen-cli",
      "outdated": true,
      "version": "0.0.0"
    },
    {
      "name": "bullpen-bracket",
      "outdated": true,
      "version": "0.0.0"
    }
  ],
  "solana": {
    "address": null,
    "enabled": false,
    "jupiter_base_url": null,
    "referral_account": null
  },
  "split_brain_warning": null,
  "support": {
    "bug_reports": "https://github.com/BullpenFi/bullpen-cli-releases/issues",
    "docs": "https://cli.bullpen.fi",
    "file_a_ticket": "https://bullpen-help.freshdesk.com/support/tickets/new"
  },
  "trade_auth_blocked": false,
  "trade_auth_blocker_reason": null,
  "trade_auth_diagnostic_note": "not_checked: passive status performs no Bullpen profile, auth, or Turnkey network calls; run `bullpen doctor auth --output json`.",
  "trade_auth_state": "unknown_inconclusive",
  "trading_access": {
    "deposit_wallet_address": null,
    "legal_eligibility_determined": false,
    "normal_prediction_trade_route": "bullpen_account_services",
    "note": "Prediction trade commands route through Bullpen account services using your login session; direct diagnostics describe their own request path. Bullpen routing does not change provider controls or legal eligibility.",
    "proxy_routes_prediction_trades": true,
    "route_observation_changes_eligibility": false,
    "signer_source": "turnkey_disabled",
    "wallet_kind": null,
    "wallet_kind_label": null
  },
  "update_check": {
    "detail": "Passive status does not contact release services.",
    "next_command": "bullpen upgrade",
    "status": "not_checked"
  },
  "update_available": null,
  "version": "0.1.117 (Alpha)"
}

Stability¶

Patch releases may add nullable or optional fields. Minor releases may add required fields or increment schema_version. Major releases may remove or rename fields.

bullpen status¶