The agent

Bring the agent you already use.

Agentic PDF will connect to the AI agent installed on your computer and let it read your document with you. It finds, summarizes and cites pages, and it asks before it changes anything. No API keys, no new subscription, no upload to us.

In developmentNot in today's download. Follow the work in issue #18.
Agentic PDFthe reader
Your agentClaude Code, Codex, Gemini CLI
PDF toolsserved by the reader
Your documentthe open tab

The conversationThe reader talks to your agent over the open Agent Client Protocol, and shows its plan, steps and answer in a panel beside the page.

The documentThe agent reaches your PDF only through tools the reader provides over MCP, in small and bounded pieces.

Your computerThe tools connect back to the open tab over a local socket. Nothing passes through a server of ours.

How it works

From question to cited answer, step by step.

This is the design in issue #18. Details may change as it is built and tested against real agents.

The reader starts your agent

It finds agents installed on your computer and starts the one you pick as a child process, speaking ACP over standard input and output. Claude Code and Codex connect through ACP adapters, and Gemini CLI supports ACP directly.

It hands over the PDF tools

When the session opens, session/new gives the agent the reader's own MCP server. The agent starts it, and it attaches to the exact tab you are reading.

You ask, it reads

Your question goes out with a link to the open file. The agent calls the tools it needs, such as the outline, a search, or the text of a few pages, and each call appears in the panel as it happens.

The answer arrives with pages

The reply streams into the panel. Every page reference is a link that jumps to the page and outlines the passage it came from.

Changes wait for you

Before the agent highlights text or adds a note, the reader asks you: allow once, always allow, or reject. Reading never changes your file.

One session, in messages
Illustrative, simplified
Agree on version 1initialize
Open a session with the PDF toolssession/new
"Summarize the exit terms"session/prompt
tool_call: searchFinds the clauses
agent_message_chunkAnswer with page links
request_permission"May I highlight 2 passages?"
You chose allow onceselected: allow_once
end_turnDone
The tools

Precise tools, not a pasted file.

The agent never receives your whole PDF in one go. It asks for exactly what it needs, and long documents are read in bounded pieces so the reader stays fast and its memory stays flat.

document_info

Page count, title, and which pages have no text layer, so nothing is skipped silently.

Read
get_outline

The table of contents, so the agent can plan what to read.

Read
get_text

Text for a range of pages, capped by max_chars with a next_page cursor to continue.

Read
search

Every match with its page and position on the page.

Read
get_selection

Whatever you have selected, so you can ask about exactly that.

Read
goto_page

Takes you to the page being discussed.

Navigate
highlight

Marks passages on the page, after you approve.

Asks first
add_note

Adds a note to a page, after you approve.

Asks first

Tool names are proposed and may change. The same tools will also be available to agents you run outside the reader.

First feature

Summarize a document in one click.

The first thing the agent panel will do. One button sends a fixed request: summarize, cite pages for every point, and say which pages could not be read.

  1. Outline firstThe agent reads the page count, the sections, and which pages have text.
  2. Then the text, in rangesIt reads a few pages at a time with a cursor, whatever the length of the document.
  3. A summary with pagesKey points, each linked to the page it came from.
  4. Gaps namedScanned pages without a text layer are listed as not covered, never silently skipped.

Office Lease Agreement

Harbor Point Holdings and Lumen Studio Ltd

12.1 Either party may terminate this Lease on the third anniversary by giving not less than six months' written notice.

Page 8: scanned, no text layer

13. The Rent is reviewed each year in line with the consumer price index, capped at four per cent.

Your agentReady
Summary
  • Break clauseYear three, six months' notice p. 4
  • Rent reviewYearly, capped at 4% p. 4

Pages 8 and 9 are scanned and were not covered.

Illustration, in development
Privacy and control

Your document, your agent, your call.

Stays on your computer

The reader never uploads your PDF. Text leaves your machine only if the agent you chose sends it to its own service, under that agent's terms.

No keys, no lock-in

You use the agent and subscription you already have, and can switch agents whenever you like.

Reading is automatic, writing is not

Highlights and notes always wait for your approval: allow once, always allow, or reject.

Answers you can check

Every point links to its page, so you can verify it in a click instead of trusting it.

Still open

What we have not solved yet.

Honest limits, tracked in issue #18.

Scanned pages

Pages without a text layer cannot be read yet. On-device text recognition, Vision on macOS and the built-in recognizer on Windows, is being considered. Until then those pages are reported as not covered.

Very long documents

The tools keep every read small, but how well an agent summarizes hundreds of pages depends on that agent. We will measure it with real agents before making claims.

Which agents, exactly

Claude Code, Codex and Gemini CLI are the first targets. Setup steps differ by agent, and the reader will say clearly when none is installed.

Get involved

Read today. Bring your agent soon.

Follow the agent workProgress, design and open questions in issue #18.Open issue #18
Star the projectFree and open source under the MIT license.Star on GitHub
Download the readerThe fast, native reader is available now for macOS and Windows.Download