Biblioplex Help
Find help for the main Biblioplex workflows: tracking cards, organizing storage, building
decks, syncing data, sharing lists, using collection chat, and working from the command
line or an agent.
Collection Basics
Use the collection view to scan, search, sort, edit, and price your singles.
Starting with an empty collection
-
After a first sign-in finishes syncing to a genuinely empty account, a two-step
setup guide asks whether you want to import a collection, import a deck, or add
cards one by one. The next step explains the selected path, introduces the
collection, container, deck, history, export, and sharing capabilities, then opens
the existing workspace for that task.
-
Closing or finishing the guide keeps it from appearing automatically again on that
account in the current browser. An empty collection always keeps a Show setup guide
action, and signed-in users can also choose Restart setup guide from the Account
section in Settings. Restarting the guide is safe on a populated account and does
not change collection data.
-
Opening a container or deck that has never held any cards shows a plain no-cards-yet
message. That is different from a search or filter matching nothing in a non-empty
collection, which shows the zero-results debugger described under Search and filters
below.
Table and visual views
-
The collection view has a table mode for dense editing and a visual mode for
browsing card images.
-
Visual View settings offer one full-width four-stop card-size slider. The four
unlabeled notches snap to Compact, Medium, Large, and Extra large; the current named
size and pixel width appear above the track and are announced by assistive
technology. The choice is remembered. You can instead display cards as fixed binder
pages in 2x2, 3x3, 4x4, or 4x3 pocket layouts.
-
Normal finishes stay visually quiet. When Visible fields > Finishes is enabled in
visual view, foil and etched cards show their finish in the metadata line beneath
the card, between quantity and price, plus the same material treatment used by the
enlarged card in Details. Disabling Finishes removes both the label and treatment.
-
On pointer devices, visual card art gains one solid, fully opaque purple outline on
hover so it reads as clickable without moving or shifting layout. Keyboard focus
uses the same treatment, including in reduced-motion mode.
-
Sort the table by name, set, collector number, finish, rarity, condition, container,
quantity, or price.
-
In table View settings, choose comfortable or compact row density, show or hide
columns, drag headers to reorder, resize their edges, or reset the entire table
layout. The Select and Name columns stay pinned while you scroll a wide table
horizontally.
-
Table tags stay on one line in dense mode. When the cell cannot show every tag, a +N
badge reports how many are hidden; click the cell or its + action to review and edit
the full tag list.
-
Open a card from either view to see its price, make quick quantity or container
changes, add another copy, and jump among other tracked copies of the same card.
Each tracked copy identifies its set and collector number separately from finish,
condition, language, location, and quantity. An open card is reflected in the
address bar, so refresh restores it and the browser Back button closes it without
losing your collection view.
-
Hover or keyboard-focus a displayed price to see its currency, Scryfall provenance,
latest snapshot date when available, and whether a regular-price fallback is
standing in for a missing exact-finish price.
-
The card drawer also shows which of your Biblioplex decks use the card. Less-common
printing, finish, condition, language, and tag corrections stay under Edit details.
-
Use the previous and next buttons, or the j and k keys, to step through the drawer
in your current filtered and sorted order without closing it. Stepping stops at
either end of the list, and j/k are ignored while you are typing in a field. Closing
the drawer returns you to the card you opened it from.
Search and filters
-
Plain text searches card names. If you type more than one word, each word must
match.
-
The sidebar has three destinations: Collection, Containers, and Decks. Their
semantic icons stay consistent in the sidebar and page headings. Containers and
Decks are collapsible lists; hover or move keyboard focus into a group row to reveal
its Add action. Cards with no container appear as a muted No container set row at
the end of Containers, with a live count, and it is hidden when every card has a
container.
-
On desktop, the account/workspace trigger occupies the top-left sidebar row. The
account identity itself opens the menu and has no dropdown chevron, leaving more
room for the account address. Hover the sidebar or move keyboard focus into it to
reveal the separate collapse control beside the account trigger. A closed sidebar
gives the page its full width: hover or focus the menu button at the top-left to
peek at it, or click to lock it open. The [ key also toggles the pinned state. On
tablet-sized workspaces, the sidebar starts closed so the collection keeps enough
room.
-
On phones, Browse & filter opens a drawer with separate Browse, Filters, and
View tabs. Browse contains search and collection destinations, Filters contains card
criteria, and View contains table/visual and saved-view settings.
- Use filters for set, rarity, finish, tag, and format legality.
-
On desktop, Search expands across the available collection toolbar space. Filters
sits in the right action cluster beside the Table/Visual toggle and View settings;
its popover stays anchored to the Filters button and flips or clamps inside narrow
viewports. Escape, outside click, or Apply closes it and returns focus. While you
edit Filters, Apply previews the exact number of cards the draft will show.
-
Applied filters (set, tag, format legality, rarity, finish, color, color identity,
oracle text, type line, mana cost/value, power, toughness, loyalty, condition,
language, container, and price) show as removable chips above the list. Click a chip
to change its value in place, or use its remove button to clear just that one - no
need to reopen the panel for either.
-
Use shortcuts for precise searches: t:creature for type, c:rg for colors,
o:"flying" for rules text, set:fin for set, tag:trade for tags, loc:bulk
for a container, and loc:none for cards with no container.
-
Use comparisons like cmc<=3 for mana value 3 or less and qty>=2 for two or
more copies. Put a dash before a term to exclude it.
-
Start typing a shortcut like set: or loc: and a dropdown suggests the field, then
matching values from your own collection (set codes, container names, tags, and so
on) - pick one or keep typing your own. Plain name searches never trigger it.
-
When a search and filter combination matches nothing, the empty state names the
specific filter responsible when there is one clear cause, with a button to remove
just that filter or clear everything. When legality or price data for some cards
hasn't finished loading yet, that is called out instead of blaming the format or
price filter - unknown legality and unknown price never count as match failures, so
cards stay visible while their data backfills.
Keyboard shortcuts
-
Ctrl+K (Cmd+K on Mac) opens quick jump: type to find a card, a container or deck, or
run an action - new deck, new container, import, export, open history, and settings,
alongside help, feedback, and chat.
-
Press / to focus search from anywhere. Focusing an empty search field shows your
recent searches with a quiet recent label; use the pointer or Arrow keys and Enter
to pick one, or keep typing.
-
In table view, arrow keys move a keyboard cursor between rows. Shift+Up or
Shift+Down extends a selection range from where you started. Space selects the
focused row without opening it; Enter opens it.
-
Inside the card drawer, use j and k to step to the next or previous card in your
current filtered and sorted order, same as the previous and next buttons.
-
The [ key closes the sidebar or locks it open on desktop; when it is closed, hover
or focus the top-left menu button for a temporary peek. Elsewhere, a (add cards), h
(help in a new tab), f (capture feedback), and c (collection chat) are one-key
shortcuts, and Ctrl+Z (Cmd+Z) undoes your last change. Help also opens in a new tab
when chosen from quick jump, so your collection position and filters stay in place.
All of these are ignored while you are typing in a field.
Saved views
-
A new account starts with one saved Collection view, which is both current and
default. It owns the current search, filters, sort, columns, and table or visual
layout.
-
Changing those controls marks the current saved view as modified. Use Save changes
to update it, or Save as new to keep the original and activate a new saved view.
-
The active saved view appears in one management row. Its ellipsis menu contains
Rename, Duplicate, Set as default, and Delete; the default view explains why Delete
is unavailable until another view is made default. The list below remains the quick
way to switch views, and Biblioplex asks before replacing unsaved modifications.
-
Saved views synchronize with the rest of your collection preferences across
signed-in devices.
Link to this view
-
Copy view link, in the view settings panel, copies a link back to your current
filters, sort, and table or visual mode. Opening that link creates an ad-hoc view
and never overwrites a saved view; use Save as new if you want to keep it.
-
This is not the Share link under Export and share - it does not grant anyone read
access to your cards. It is a private bookmark to a view of your own collection, for
you.
-
The link never includes search text, tags, container names, or oracle/type-line text
searches, since those can contain personal wording. It carries only closed choices -
set, rarity, finish, format, format legality, color, condition, language, and
numeric ranges like price or mana value.
Totals
-
The footer summarizes the current collection or view: unique cards, total cards,
estimated value, and container or deck counts where they apply.
-
The right end of the footer shows a compact rendering of the most recent change, a
one-click undo only when that exact event is still safe to reverse, and a history
link that opens the full history panel. Hover or focus the compact line or an entity
in it to reveal the complete event. It updates for changes made in chat, the CLI, or
by an agent as well as your own edits. On desktop, Help, Feedback, Chat, and Add
remain individually visible at the lower right. On smaller screens, those actions
and History live behind the compact More launcher.
-
Ctrl+Z (Cmd+Z on Mac) also triggers that same undo, as long as you are not typing in
a field. Large undos still ask you to confirm first.
-
Prices come from Scryfall data when available and are estimates for collection
management, not financial records.
History and undo
-
Open the history panel from the history link in the footer. It lists recent changes
with the time, where each change came from, and per-entry undo, redo, and remove
controls. Undo and redo appear only while the exact stack transition remains safe;
their accessible labels state the full action they will reverse or reapply.
-
History summaries come from one structured event formatter shared by the panel and
footer. They distinguish create, delete, rename, set, change, clear, add, remove,
and move; card edits name fields such as quantity, printing, finish, condition,
language, tags, container, and deck zone. Bulk actions name representative cards and
disclose the accurate remaining count.
-
Container, deck, and tag references use compact inline identity chips with the full
captured name and historical emoji or semantic fallback icon, so a later rename or
deletion does not rewrite older history. Existing containers and decks can be opened
from their history references; deleted entities remain readable without becoming
broken links. Card names are restrained underlined text links rather than chips.
Hovering or focusing one opens its card preview in the global overlay, wholly clear
of the History panel. The footer keeps the line compact, and hover or keyboard focus
reveals its complete event and full names without shifting the page.
-
A bulk edit or bulk delete on multiple selected cards is recorded as one entry;
undoing it restores every card in that batch together, not one at a time.
-
The panel scopes to what you are looking at. Switch between This view and All at the
top; the choice is remembered.
-
History is stored per browser and capped, so it is a recent-activity log rather than
a permanent audit trail. Sync keeps a smaller shared window across your devices.
Add And Import Cards
Add one card at a time, paste shorthand entries, or import a spreadsheet from another
collection tool.
Add one card
-
Open Add Cards, search for a card, choose the exact printing, then confirm the
preview.
-
Use set code and collector number when you care about the printing, for example fin
142.
-
Set finish, condition, language, quantity, tags, and container before committing the
card.
Paste shorthand
-
The text add flow accepts compact lines such as two fin 142 foil lp in breya deck.
-
Biblioplex parses quantity, set, collector number, finish, condition, language, and
container when it can.
- If a line is ambiguous, choose an exact printing before saving.
Import a spreadsheet or list
-
The import tab leads with how you're bringing cards in: upload a file, paste a list,
or start from a provider link. Picking one reveals just that input; a compact what
can I import? panel next to it lists the supported fields, two working examples, and
a downloadable template CSV.
-
Paste or upload spreadsheet exports from tools such as Moxfield, Manabox, Deckbox,
or Biblioplex's own export format. Biblioplex detects common headers automatically.
-
If the headers aren't recognized, Biblioplex asks you to match each column to a
field once, showing a sample value from the first row. That mapping is remembered,
so importing the same spreadsheet shape again skips the question.
-
Before you confirm, the preview breaks rows into add, merge quantity, and needs
attention, with a status next to each row. Choose whether cards already in your
collection get their quantity added to or are left alone, and override that choice
per row.
-
Confirming shows a receipt: the add/merge/attention counts, any warnings, the
destination, and buttons to view the imported cards or undo the whole import in one
step.
- After import, Biblioplex fills in missing prices and search info when it can.
Scan cards
-
Open the scan tab and either use this device's camera or pair a phone by scanning
the QR code shown on desktop.
-
Every card scanned from a paired phone lands in a live session queue on desktop,
showing each card as pending, confirmed, corrected, or skipped, with running totals.
-
Phone-paired adds use the destination, condition, and tags currently set in the
desktop add session, not anything picked on the phone, so a whole stack lands in the
same container without repicking it per card.
-
Undo any confirmed or corrected entry from the session queue without touching the
phone, or use fix match on any entry to search for the right card and re-add it if
the scan matched the wrong printing.
-
The session queue stays populated if you close and reopen the add panel during the
same visit.
Storage And Containers
Track where cards live with containers, decks, tags, and bulk actions.
Containers
-
Containers organize the physical cards in Storage. Decks are managed separately in
the Decks workspace.
-
The Storage view is for container management: create, rename, color-label, choose an
icon, and manage containers. Icons can be a Biblioplex glyph, mana symbol, Magic set
symbol, or emoji. Related Magic products that belong to the same set family share
one set-symbol choice. Opening a container moves to the Collection tab scoped to
that container; use the quiet actions menu beside its heading to edit container
information.
-
Moving a card updates its collection entry and the relevant container views.
Deleting a non-empty container leaves its cards without a container but keeps them
in your collection.
-
Every place you pick a destination container - adding a card, bulk-moving selected
cards, editing a card, moving a card from its row or location pill's right-click
menu, or importing - also lets you create a missing container inline with a name and
an icon. Confirming returns you to that same picker (or, from a right-click menu,
applies the move) with the new container selected and anything else you had set up
(like a pending bulk edit) untouched. Entering a name that already exists selects
that container instead of creating a duplicate.
-
The Storage home page stays a roomy card grid while you only have a handful of
containers. Once it grows past a handful, a sort and layout toolbar appears above
the cards: sort by name, recent, or value, and switch to a compact list for scanning
a lot of containers at once. Search (the sidebar search box) already filters storage
by name regardless of size. Your sort and layout choice is remembered on this
device.
Container views
-
Your saved Collection views remain available while browsing a container, so you can
switch filters and layouts without creating a separate container default. Because
the page is already scoped, its cards and table do not repeat the current container
as a separate field.
-
Grid view shows cards as pages (4x3, 3x3, 2x2, or list) with filters for color,
type, search, sorting, and price; exploratory sort and filter views do not change
the saved slot layout.
-
List view is a dense, scoped inventory list for sorting, filtering, and bulk edits.
-
Leaving a container, deck, or collection view and coming back silently restores
where you scrolled to and which row you had open for that scope.
Bulk edit
-
Select rows in table view to move, tag, untag, correct condition, correct finish,
correct language, or delete many cards at once.
- Bulk edits preview their pending action in the toolbar before they commit.
- Use clear to leave selection mode without changing cards.
-
If a filter or search hides some of your selected cards, the toolbar states how many
are hidden with review and clear hidden actions. Bulk actions only ever apply to the
cards currently visible - hidden selections are never silently included. Sorting
never hides a card, so it never affects your selection.
-
Export selected opens the same export data flow used from the account menu, scoped
to your selection (still only the visible, non-hidden cards).
-
On desktop, you can also drag a card row - or your current selection - onto a
container or deck in the left sidebar to move it there in one step. This is a
shortcut for the same move, not a separate one: it still only moves the visible,
non-hidden cards, and dropping outside a real container or deck does nothing. The
"move to..." menu and keyboard selection remain fully supported.
Decks
Create deck containers, build lists, check formats, and export decklists.
Create and open decks
- Use Decks to create a deck container, then open its workspace.
-
Decks can include maindeck, sideboard, maybeboard, and commander cards where
supported by the workspace.
-
Deck history tracks meaningful edits so recent changes are visible. Open the history
panel from the footer while a deck is open and it scopes itself to that deck.
-
The Decks home page stays a roomy card grid while you only have a handful of decks.
Once it grows past a handful, a sort and layout toolbar appears above the cards:
sort by name, recent, or value, and switch to a compact list for scanning a lot of
decks at once. Search (the sidebar search box) already filters decks by name
regardless of size. Your sort and layout choice is remembered on this device.
Import a decklist into a new deck
-
Choose import when creating a deck, then paste a decklist or a provider URL
(Moxfield, Archidekt, MTGGoldfish, and similar).
-
Provider imports bring over the deck name, description, and format whenever the
source supplies them. Main deck, sideboard, commander/companion, and maybeboard
cards keep their quantities and separate boards. MTGGoldfish URL imports recognize
its blank-line sideboard separator; pasted lists should use explicit section
headings or SB: prefixes.
-
When the source omits the format, Biblioplex makes a best-effort inference from
commander markers, deck size, copy counts, and resolved card legality across the
main deck and sideboard. It tries Standard, Pauper, Pioneer, Modern, Legacy, then
Vintage for 60–80-card constructed lists and labels the result inferred in the
review. Source formats always take priority; incomplete or uncertain lists remain
unset. You can correct the format in Edit details after importing.
-
Before the deck is created, a review screen shows what was detected: commander and
partners, format, maindeck/sideboard/maybeboard totals, unknown cards, unspecified
printings, and duplicate lines.
-
Source-selected sets and collector numbers are preserved when available. MTGGoldfish
imports use the author's saved versions when Use Specific Card Versions is enabled,
not the site's automatically displayed cheapest versions. A neutral printing not
specified label means the source only provided the card name; Biblioplex selects a
default printing that you can change after importing. An explicitly requested
printing that cannot be matched remains a warning instead of being silently replaced
by another edition.
-
Nothing is created yet at that point. Go back to edit the pasted list or URL and try
again, or confirm to create the deck with those cards. After a successful import,
Biblioplex adds the deck to Decks, opens its workspace, and records both its total
card count and unique-card count in history.
-
If any card cannot be resolved, confirmation stops without creating a partial deck
or adding owned copies. Correct the unknown card or retry the lookup instead of
losing it silently.
-
Closing or canceling the review leaves your collection and deck list exactly as they
were - there is no partially created deck to clean up.
Build and review
-
Cards can be grouped by type, mana value, color, or rarity. Sparse neighboring
mana-value stacks share a column automatically while tall stacks and lands keep
their own columns.
-
The deck workspace shows counts, legality cues, deck details, sample hands, and card
previews. On desktop, the preview beside the deck keeps the selected card's
printing, rarity, finish, condition, language, container, treatments, promo types,
and tags visible whenever those details are available; click it to open the full
card drawer. In visual and gallery views, cards with multiple copies have a numbered
tab on their left edge; single-copy cards have no tab. Foil and etched cards use the
same visible material treatment as other card surfaces without placing a finish
label over the artwork.
-
In every deck format, the visual stacks give the maindeck the full workspace width.
Sideboard, maybeboard, and Limited pool sections follow underneath it. Small,
medium, and large set fixed, predictable stack sizes on desktop; narrow screens may
compress them to avoid overflow. Biblioplex adds another column only when it
meaningfully shortens the tallest stack, otherwise neighboring groups share a column
at the selected size.
-
Use format selection to check legality for Commander, Standard, Pioneer, Modern,
Legacy, Vintage, or Pauper.
Export and share
- Export decklists for external tools from the deck workspace.
-
Share creates a read-only snapshot link for a deck or collection view without giving
edit access.
-
Opening a shared link shows a focused read-only view: a banner across the top names
what is being shared, and the table or card view fills the width. Exit in that
banner returns you to your own collection.
-
Shared snapshots omit row selection and every editing action, including move,
add-copy, and delete controls in card details. You can still browse card details.
The sidebar and user account actions stay hidden; what you are signed in as does not
change what a shared link shows, and viewing one never touches your own collection.
Ownership and missing cards
-
The deck header shows an owned count against the maindeck total. When every card is
on hand it reads as a plain count; when cards are short, it becomes an "N owned
/ M missing" button.
-
Opening it lists what's short, grouped into not owned, a different printing owned,
and ambiguous (several other printings owned) - each entry explains the match, like
owning a copy in another container under a different set.
-
From there you can point the deck at a printing you already own, choose which owned
copy to use when more than one qualifies, or mark an entry as leave missing to quiet
it until something changes. For commanders and partners, changing to an owned
printing updates the command-zone card and deck header together; editing other deck
details keeps an already-tracked printing unless you change the card itself.
Sync, Backup, And Account
Your collection lives in your account in the cloud. This browser keeps a fast read copy
so the app opens instantly.
Data on this device
-
Your signed-in collection is stored in the cloud; this browser keeps a read copy for
instant loading.
-
Editing needs you to be signed in and online. Signed in but offline, you can still
browse the cached read copy, but changes are disabled rather than saved somewhere
risky.
-
A save either reaches the cloud while you watch or fails with a clear error - there
is no background queue, so what you see after a save is what is stored.
-
Signing out clears the read copy from this browser, and opening Biblioplex while
signed out shows the signed-out demo instead of your last collection. Nothing is
lost - your collection lives in your account, and signing back in restores it from
the cloud.
-
Use export data before signing out or clearing browser data if you want a portable
copy on hand.
-
Signed out, the account chip reads "demo - not saved" while the welcome
demo is loaded; signing in replaces the demo with your account collection, and demo
cards are never saved. If you try an edit in the demo, Biblioplex reminds you at
that moment that the change is temporary. Empty signed-in collections show a zero
state, with add and import available from the normal app controls.
Account sync
-
The top-left account menu stays compact: it shows your full account name, then
Account, Settings, Export data, and Sign out. Routine sync status is kept out of
this menu.
-
When you are signed in, Biblioplex keeps changes in sync across your signed-in
browsers. Everyday edits sync incrementally - only the change itself travels, not
your whole collection.
-
Card art, prices, and printing details are not carried in the cloud copy, so
Biblioplex refetches them from Scryfall after you sign in. A progress toast shows
how many cards have been filled in while that runs, and clears itself when the last
one lands.
-
Signed-in users manage personal access tokens from the Account section in Settings,
keeping this less-common tool out of the main account menu (see Automation and
integrations).
-
If two devices edit the same card at the same time, Biblioplex tries to protect the
newer work instead of silently overwriting it.
-
During temporary signed-in connecting, offline, or bootstrap-error states, Add and
row-selection controls remain in place so the page does not jump, disabled while
writes are blocked and re-enabled in place on recovery. Startup, account
restoration, and brief connection hiccups stay silent: a connection problem waits
about eight seconds before it says anything, so a momentary drop that fixes itself
never interrupts you. If it lasts, one banner across the top explains the situation
and offers Retry sync. A change that actually failed to save says so immediately,
and that message stays until you dismiss it or a later change saves. Only shared and
signed-out demo views omit mutation controls.
-
Background prices, Scryfall metadata, set icons, search indexing, and remote
revisions never reorder or rebuild the screen you are currently using. Routine
background work stays silent and applies at your next explicit route, view, filter,
sort, reload, or mutation boundary. Automatic card-detail backfills do not flash a
separate progress message.
-
A failed sync always shows as an error banner - there is no silent queue - while
routine successful syncing stays out of the way.
-
If sync looks stuck, copy the support details from settings and include them with a
bug report.
Collection size limits
-
Collections up to about 50,000 cards sync comfortably. Cloud storage does not refuse
saves by size, and everyday edits transfer only the change itself.
-
Cloud storage is not presented as a quota you need to manage; at this scale, the
practical limit is the browser's memory rather than a sync meter.
-
The first sync on a new device still downloads the whole collection once; after
that, updates arrive incrementally. Beyond roughly 50,000 cards the practical limit
becomes your browser's memory, not the cloud.
Backups and recovery
-
Export data asks for a scope every time - entire collection, only the cards matching
your current filters, or just the cards you have selected - so a stale filter can
never quietly produce a partial file you mistake for a full backup. It also
remembers the format you last used and shows a receipt with the count, format, and
filename after the download.
-
Biblioplex JSON, the full portable backup with containers, decks, and tags, is only
offered for the entire-collection scope; the CSV formats support all three scopes.
-
History and recovery points can help undo big changes, like deleting cards or
replacing your collection.
-
Delete everything intentionally clears collection, decks, storage, and history for
the current browser state.
Collection Chat
Ask natural-language questions and stage edits through the chat surface.
Ask questions
-
Use collection chat to ask about cards, prices, containers, tags, deck contents, and
collection summaries. Questions about the most recently added or acquired card use
its latest acquisition timestamp, while recently changed or moved questions use edit
history instead.
-
Chat answers use the current collection and may return cards you can open in the
app.
-
Collection chat requires signing in — opening it while signed out shows a sign-in
prompt in place of the message box.
Preview edits
-
For risky changes, chat creates a preview instead of immediately editing your
collection.
- Review the preview, then apply or discard it.
- Exact card additions may ask for a printing when the request is ambiguous.
Before changes happen
- Chat can suggest changes, but risky edits wait for your approval.
-
Biblioplex checks that you are still signed in and allowed to make the change before
applying it.
-
When possible, Biblioplex creates a recovery point before applying a chat change.
Automation And Integrations
Work with your collection outside the app: a command-line tool, agent access over MCP,
and personal access tokens.
Command line (CLI)
-
Biblioplex has a command-line tool, biblioplex (short alias bp), for managing your
collection from a terminal.
-
Install it with npm install -g biblioplex or brew install benson/tap/biblioplex,
then run bp login to sign in.
-
It can search, add, edit, move, import, and export, and prints machine-readable
output with --json plus meaningful exit codes for scripts and agents.
Agents and MCP
-
Biblioplex exposes an MCP server so external AI assistants can read your collection
and stage changes.
-
Like collection chat, agent edits are previewed and need your confirmation before
anything is written, and a recovery point is created before each applied change.
Personal access tokens
-
For headless or automated use without a browser sign-in, create a personal access
token from the Account section in Settings while signed in.
-
Use it with the CLI or an agent by setting the BIBLIOPLEX_TOKEN environment
variable.
-
Tokens carry read-only or read-and-write access and can be revoked at any time.
Preferences And Troubleshooting
Adjust the interface, load test data, and get unstuck.
Display preferences
-
Settings include theme, text case, text size, table-cell wrapping, anonymous
analytics and session-replay controls, copyable support details, and signed-in
access-token management.
- Preferences are stored locally in the browser.
-
The layout adapts across desktop and mobile, with drawers and floating actions
replacing sidebars on small screens.
Analytics and session replay
-
For the US service, anonymous PostHog product analytics and session replay are on by
default to help find confusing interactions. Analytics requests are routed through
the first-party domain t.bensonperry.com before PostHog Cloud US processes them.
Biblioplex does not attach your Clerk account identity or email to PostHog and does
not create a PostHog person profile.
-
Replays can include the Biblioplex workspace you see and use, including card and
deck names, searches, container names, imported text, and form values. Account and
Clerk authentication surfaces and password fields are excluded; URL query strings,
console logs, network bodies, error capture, and performance capture are not
collected.
-
Open Settings to turn analytics and replay off or back on for this browser. A
supported Global Privacy Control or Do Not Track browser signal keeps them off
automatically.
Test data
-
Reset test data loads a representative sample collection for development and demos.
- Use it only when you are comfortable replacing the current local state.
When something feels wrong
-
Check whether filters, search, or format legality are narrowing the current view.
- Use clear all filters to get back to the full collection.
- Copy the support details from settings when reporting a bug.