What is pdf-analyzer AGENTS.md?

Project instructions for pdf-analyzer, a tool that helps AI agents analyse PDF files.

Making changes to the pdf-analyzer project, including work related to analysing PDF documents for AI agents.

It gives an agent the repository’s expected guidance when working on PDF analysis features.

How IntelligentElectron/pdf-analyzer configures Codex and OpenCode

Reuse

Borrowing it

Nothing to install: this file belongs to IntelligentElectron/pdf-analyzer. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/IntelligentElectron/pdf-analyzer/main/AGENTS.md

Clone the repo

git clone --depth 1 https://github.com/IntelligentElectron/pdf-analyzer

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/intelligentelectron/pdf-analyzer/agents-md/github.svg)](https://agentmods.dev/instructions/intelligentelectron/pdf-analyzer/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/intelligentelectron/pdf-analyzer/agents-md"><img src="https://agentmods.dev/badge/instructions/intelligentelectron/pdf-analyzer/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/intelligentelectron/pdf-analyzer/agents-md"><img src="https://agentmods.dev/badge/instructions/intelligentelectron/pdf-analyzer/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 1,897 This file is loaded in full into every session.

When invoked 1,897 The same file — it is already loaded in full.

Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin 100% copy Near-identical to another mod in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.01897	$0.01897
Opus 5.5	$0.00759	$0.00759
Sonnet 5.5	$0.00379	$0.00379
Haiku 4.5	$0.00190	$0.00190

Measured 5d ago against content hash 5700df7237d2, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade B, and why

pdf-analyzer AGENTS.md scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads MCP configurationmediumAgent snooping

mcp.json carries server URLs and auth tokens; reading it lets a mod discover and abuse other integrations.

Point `.mcp.json`'s HTTP MCP entry at `http://localhost:8080/mcp`. When the proxy stops, the MCP disconnects until you start it again. No secrets live in `.mcp.json` — auth is handled per-request by the proxy against you

Origin

This is a copy

100% identical to skills AGENTS.md — 204 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

AGENTS.md · 203 lines

How it starts

The opening of the file, as written. The whole thing — 203 lines — stays where its author put it; the contents beside it link to each section on GitHub.

PDF Analyzer MCP Server

CRITICAL: Branch Protection

NEVER push directly to main. ALL changes must go through a PR.

Create a feature branch: git checkout -b <branch-name>
Make changes and commit
Push the branch: git push -u origin <branch-name>
Create PR: gh pr create

If you accidentally commit to main locally, fix it:

git branch <branch-name>          # Create branch from current commit
git reset --hard origin/main      # Reset main to match remote
git checkout <branch-name>        # Switch to your branch
git push -u origin <branch-name>  # Push and create PR

CRITICAL: Model Configuration

Models per provider (do not change without discussion). Users choose during --setup:

Google Gemini: gemini-3-flash-preview (fast) / gemini-3.1-pro-preview (flagship)
Anthropic Claude: claude-sonnet-4-6 (fast) / claude-opus-4-7 (flagship) / claude-opus-4-6 (previous flagship, still selectable)
OpenAI: gpt-5.4-mini (fast) / gpt-5.4 (flagship)

Thinking/reasoning is set to minimum for all models (document analysis doesn't benefit from extended thinking).

References (Google File API for large PDFs):

Overview

Standalone MCP server for analyzing PDF documents using AI. Supports multiple LLM providers (Google Gemini, Anthropic Claude, OpenAI) via the Vercel AI SDK. Distributed as self-updating binaries for all platforms. Users choose their provider and provide an API key during setup.

Build & Package

Uses Bun to compile TypeScript into standalone executables:

# Build all platforms
npm run compile:all

# Or individual platforms
bun build src/index.ts --compile --target=bun-darwin-arm64 --outfile=bin/pdf-analyzer-darwin-arm64
bun build src/index.ts --compile --target=bun-darwin-x64 --outfile=bin/pdf-analyzer-darwin-x64
bun build src/index.ts --compile --target=bun-linux-arm64 --outfile=bin/pdf-analyzer-linux-arm64
bun build src/index.ts --compile --target=bun-linux-x64 --outfile=bin/pdf-analyzer-linux-x64
bun build src/index.ts --compile --target=bun-windows-x64 --outfile=bin/pdf-analyzer-windows-x64.exe

Read the full file on GitHub · 203 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

5d ago Changed · +202 lines · +1,893 tokens per session scan A → B 5700df7237d2
2mo ago First seen · 1 lines · 4 tokens per session scan A 6ebdb617a810

Subscribe to this mod's changes

pdf-analyzer AGENTS.md is an instructions file published in the GitHub repository IntelligentElectron/pdf-analyzer (4 stars, last pushed 5d ago), licensed Apache-2.0. It adds 1,897 tokens to every session, about $0.0076 per session on Opus 5.5. A static security scan graded it B with 1 finding (reads mcp configuration). It is 100% identical to skills AGENTS.md, differing in 204 lines, and is treated as a copy.

Documents PDF ai mcp

pdf-analyzer AGENTS.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
pdf-analyzer AGENTS.mdIntelligentElectron/pdf-analyzer	Instructions file	4	5d ago	Apache-2.0	B	1,897	Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	today	MIT	A	7,461	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	5,649	GitHub Copilot
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	today	MIT	A	4,680	Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	3,093	GitHub Copilot
vscode ai-customization.instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	1,907	GitHub Copilot

pdf-analyzer: Instructions file for Codex