PDF is a quiet reader and annotator. The page fills the window; tools appear when you reach for them. Highlights and notes are written into the PDF itself.
Scrub the page rail.Point at the ticks at the left edge: they widen, a preview names each page, and a click goes there.
Or open Pages.Pages opens from the titlebar and the rail steps aside; pick page 4 and the readout follows.
Find a phrase.⌘F opens a compact Find: every match is lit, the active one in its own colour, with a counter.
Highlight it.Select the passage and it becomes a highlight on page 4.
Write a note.A compact note opens beside its marker, and the Notes sidebar lists the same note.
Jump with Commands.Brush from More joins the dock. ⌘P, type go 12, Return: page 12; the marks stay on page 4.
Back to the note.Choose it in Notes to return to page 4; ⌘S writes both into the PDF and “Unsaved” goes away.
Back to reading.Q quiets the dock to the current tool, then sidebars and the dock step back; the highlight stays and a column of ticks marks your place.
Settings · theme
Drawn in code with demo text. Not a recording of the app.
Field notes on margins.pdf·Unsaved
4/38
Page 9Page 9
Chapter 1 · Page 1
Field notes on margins
These notes collect small observations about how people mark the books they care about, and what those marks say about attention.
Chapter 3 asks what a reading tool should do while you read. The short answer is: very little, and only when asked.
Chapter 2 · Page 6
Small marks, long memory
A pencil tick beside a line costs nothing and keeps the place for years. Readers who mark less tend to remember where they marked.
The useful mark is the one you can find again: a page you can jump to, a note you can open without searching.
Chapter 5 · Page 12
Notes that travel with the file
A note kept in a separate library is a note that can be lost. When the mark lives in the document, it moves with the document: copied, mailed, opened years later on another machine.
This chapter collects the small habits that keep annotations useful: short notes, one colour per purpose, and a habit of saving before you close.
Chapter 3 · Page 4
On reading at the edge of the page
A margin is not empty space. It is where a reader answers back: a line under a phrase, a word in pencil, a question mark that waits for the next chapter.
Good tools for reading are mostly absent. They appear at the moment of intent and are gone before the next sentence begins.
The rest of the time, the page should have the whole window to itself, with nothing to read but what the author wrote.
read3 of 4 matches
Commands
Note · page 4×
Make this the opening line of the talk.
4/38
Saved · highlight and note are in the PDFWebGL paper
03Build receipt
What it took, counted once.
Recorded agent work behind PDF up to the cutoff below, read from session metadata and deduplicated per response. Tokens are not a bill.
84.01 hagent-session hoursSummed recorded agent and tool elapsed time across parallel sessions; not wall-clock, human work or CPU time.
Codex218 sessions2.98 B78.1% of tokens · 73.98 agent-hours
Claude Code15 sessions838.03 M21.9% of tokens · 10.03 agent-hours
Daily processed tokens UTC · Codex and Claude Code
20.73 M23 Oct
–24 Oct
–25 Oct
109.19 M26 Oct
1.09 B27 Oct
835.2 M28 Oct
600.25 M29 Oct
844.63 M30 Oct
81.32 M31 Oct
6.49 M1 Oct
21.28 M2 Oct
204.88 M3 Oct
Totals
Processed tokens
3.82 B
Cached input
3.75 B
Uncached input
54.43 M
Output
9.69 M
Cache write
9.01 M
Tokens by type
Cached input3.75 B
Uncached input54.43 M
Cache write9.01 M
Output9.69 M
Attributed models
#
Model
Share of total
Tokens
1
gpt-6.1-solCodex
75.1%
2.87 B
2
claude-opus-5-5Claude Code
21.9%
838.03 M
3
gpt-6-astraCodex
2.0%
78.07 M
4
gpt-6.1-terraCodex
0.6%
24.58 M
5
gpt-6-lunaCodex
0.1%
4.17 M
6
gpt-6-solCodex
0.1%
3.99 M
Counted. PDF app: the root Codex session and every recursive native subagent (219 threads discovered, 218 with recorded usage). PDF app: PDF-specific Claude project directories on the Mac, including the earlier PDF audit directories and saved subagents. This landing page and its release work: PDF-specific Claude sessions on the build host.
Not counted. Hermes orchestration, other projects, goal counters, any unknown custom CLI homes, and work after each cutoff.
Time. Codex: completed turns (653); 5 aborted turns excluded. Claude: only turns with a recorded duration. Codex turns overlapping in wall-clock time span 53.75 h; no wall-clock figure is claimed for Claude.
Interim cutoff. App Codex 2026-11-03 20:31 UTC; app Claude 2026-11-03 22:30 UTC; this page 2026-11-03 22:29 UTC. Work after each cutoff is not included.
04Download
Get PDF.
Free · Apple silicon (arm64) · macOS 27.0.1 or later · Linux x86_64 or arm64, glibc 2.36+ · Windows x86_64
PDF has an ad hoc signature and is not notarized, so macOS may block the first launch once.
Open the disk image and drag PDF.app to Applications.
Try opening PDF once.
Open System Settings → Privacy & Security and choose Open Anyway for PDF (some versions show Open first).
Confirm and authenticate if asked. Later launches open normally.
This makes an exception for PDF only: no terminal command, Gatekeeper stays on. If macOS reports damage or malware, don't open it; check the download. Apple's guide.
Built-in updates start with version 1.0.1; replace an older copy by hand once.
Linux
The AppImage (x86_64 or arm64) needs glibc 2.36 or later plus the desktop's own fonts, graphics drivers and display libraries. To let it update itself, save it as ~/Applications/PDF.AppImage, then make it executable and add it to the app menu (needs Python 3):
The .deb is for Debian 12 (bookworm) only, not other Debian or Ubuntu releases. Install it with sudo apt install ./PDF-*-debian12-amd64.deb (or the arm64 file); apt adds its dependencies, including zenity and the X11 keyboard bridge libxkbcommon-x11-0. To update, install the newer .deb the same way: a Debian installation never replaces itself with an AppImage.
Built-in updates start with version 1.0.1; replace an older copy by hand once. Checked on X11. Wayland is not certified.