bim-pdfv

Native PDF viewer with agent-driven navigation, search, highlight, and annotation. Open a PDF, search for text or element IDs, navigate to results, and render the current view to PNG -- all from the command line.

Verbs

Verb	What it does
bim pdfv open --file <file> [--layout <layout>] [--reuse <reuse>]	Open a PDF in a viewer window; returns pid and pipe name
bim pdfv quit [--pid <pid>] [--all <all>]	Close a pdfv session and deregister it. Omit --pid when only one session is running.
bim pdfv search [--pid <pid>] --pattern <pattern> [--literal <literal>] [--page <page>] [--max <max>]	Search PDF text; navigates and highlights matches automatically
bim pdfv navigate [--pid <pid>] --page <page>	Go to page (0-indexed)
bim pdfv highlight [--pid <pid>] --page <page> --bboxes <bboxes>	Draw highlight overlays from bbox array
bim pdfv fit [--pid <pid>]	Fit page width to window
bim pdfv render [--pid <pid>] --out <out> [--page <page>] [--dpi <dpi>]	Render current page to PNG
bim pdfv state [--pid <pid>]	Return current viewer state
bim pdfv instances	List running pdfv sessions
bim pdfv describe	Return this descriptor
bim pdfv doctor	Check environment readiness

open

bim pdfv open --file <file> [--layout <layout>] [--reuse <reuse>]

Open a PDF in a viewer window; returns pid and pipe name

• --file <file> (required) -- file
• --layout <layout> -- layout
• --reuse <reuse> -- If a session for this file already exists, return it instead of opening a new viewer

quit

bim pdfv quit [--pid <pid>] [--all <all>]

Close a pdfv session and deregister it. Omit --pid when only one session is running.

• --pid <pid> -- Instance PID from `bim pdfv instances`. Omit when only one session is running.
• --all <all> -- Quit every running pdfv session

search

bim pdfv search [--pid <pid>] --pattern <pattern> [--literal <literal>] [--page <page>] [--max <max>]

Search PDF text; navigates and highlights matches automatically

• --pid <pid> -- Instance PID from `bim pdfv instances`. Omit when only one session is running.
• --pattern <pattern> (required) -- pattern
• --literal <literal> -- literal
• --page <page> -- page
• --max <max> -- max

navigate

bim pdfv navigate [--pid <pid>] --page <page>

Go to page (0-indexed)

• --pid <pid> -- Instance PID from `bim pdfv instances`. Omit when only one session is running.
• --page <page> (required) -- page

highlight

bim pdfv highlight [--pid <pid>] --page <page> --bboxes <bboxes>

Draw highlight overlays from bbox array

• --pid <pid> -- Instance PID from `bim pdfv instances`. Omit when only one session is running.
• --page <page> (required) -- page
• --bboxes <bboxes> (required) -- bboxes

fit

bim pdfv fit [--pid <pid>]

Fit page width to window

• --pid <pid> -- Instance PID from `bim pdfv instances`. Omit when only one session is running.

render

bim pdfv render [--pid <pid>] --out <out> [--page <page>] [--dpi <dpi>]

Render current page to PNG

• --pid <pid> -- Instance PID from `bim pdfv instances`. Omit when only one session is running.
• --out <out> (required) -- out
• --page <page> -- page
• --dpi <dpi> -- dpi

state

bim pdfv state [--pid <pid>]

Return current viewer state

• --pid <pid> -- Instance PID from `bim pdfv instances`. Omit when only one session is running.

instances

bim pdfv instances

List running pdfv sessions

describe

bim pdfv describe

Return this descriptor

doctor

bim pdfv doctor

Check environment readiness