bullpen support¶
Last updated: August 26, 2026
Create a support-safe help request summary and diagnostic bundle
Usage¶
Subcommands¶
| Subcommand | Description |
|---|---|
bundle |
Build a support-safe diagnostic bundle |
Live Help¶
Create a support-safe help request summary and diagnostic bundle
Usage: bullpen support [OPTIONS] [COMMAND]
Commands:
bundle Build a support-safe diagnostic bundle
help Print this message or the help of the given subcommand(s)
Options:
--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:
# Create the raw JSON bundle for agents or support
bullpen support bundle --output json
# Create a support-safe summary and diagnostic artifact
bullpen support
Example Commands¶
Support Artifact Handoff¶
bullpen support creates a redacted JSON file on local disk and prints its
path. This file is on this machine and has not been uploaded. Attach the JSON
file to your support ticket; pasting the local path alone does not send the file
to Bullpen.
JSON output includes delivery.state: "local_file_not_uploaded",
delivery.uploaded: false, delivery.artifact_path, the compatibility
top-level artifact_path, and optional originating_context with only the
recent command family and typed error code.
Support bundle handoff is passive and redacted. It does not refresh auth,
request a signing probe, or run the per-wallet order credit probe. For
active order-credit evidence, use
bullpen polymarket wallet-audit --refresh --include-order-credit --output json;
for supported on-chain consolidation or recovery, use the command printed by
bullpen fix --refresh or bullpen recover funds --dry-run --output json.
On bullpen support bundle, --refresh, --include-order-credit, and
--include-clob-credit are passive compatibility no-ops. They are accepted
for older scripts but do not change collection behavior and do not prove
refreshed auth, signing capability, or order credit.