biblioplex

Manage your Biblioplex Magic: The Gathering collection from the terminal — search, edit, import/export, and recover, with first-class machine-readable output for scripts and agents.

install

npm install -g biblioplex
# or
brew install benson/tap/biblioplex

Installs two commands: biblioplex and the short alias bp. Requires Node.js ≥ 22.

quick start

bp login                 # sign in via your browser (read-only by default)
bp summary               # overview: unique/total counts, value, containers
bp search "finish=foil order by price desc" --limit 10

auth

• interactive (people): bp login opens your browser (OAuth 2.0 + PKCE). Add --write to allow changes; bp logout clears local credentials.
• headless / CI (no browser): set BIBLIOPLEX_TOKEN to a personal access token created in the Biblioplex web app (account menu → access tokens).

commands

| | | | --------------------------- | ------------------------------------------------------------------- | | read | summary search ls deck value prices history resolve | | write (needs --write) | add rm move edit import export | | recover | undo recover | | auth | login logout whoami |

Run bp help or bp <command> --help for usage.

writes are previewed

Every change shows a dry-run preview and asks for confirmation. Pass --yes to skip the prompt or --dry-run to preview without applying. Changes apply server-side with automatic recovery points, so bp undo and bp recover can roll them back.

for scripts & agents

• --json on any command emits a stable envelope: { "ok": true, "data": … } or { "ok": false, "error": … }.
• meaningful exit codes: 0 ok · 2 usage · 3 auth/scope · 4 not found · 5 conflict · 75 rate-limited / retryable.
• override the API origin with BIBLIOPLEX_API_ORIGIN (e.g. a local dev worker).

notes

• cloud-first: the CLI operates on your live Biblioplex collection (the web app is the source of truth).
• zero runtime dependencies.

license

MIT