# headlesson

A catalog for finding apps you can use from the CLI, MCP and APIs, by use case and by confirmed comparison axes. Unknown values are shown as unknown. Listed information is not a guarantee of actual behavior or safety.

MCP endpoint: [https://mcp.headlesson.com/mcp](https://mcp.headlesson.com/mcp)

## Features
- [Getting text out of a PDF: which recorded tool for which PDF](/features/pdf-text)
- [JSON, YAML, CSV and SQLite files: which recorded command-line tool for which file](/features/data-files)
- [Reading a web page or driving a browser: which recorded MCP server for which page](/features/web-pages)
- [Sharing a local service on the internet: three recorded tunnel clients and what was not tested](/features/tunnels)
- [jq, gojq or jaq: three runs of the same JSON filters, and where they differed](/features/jq-implementations)
- [Drawing a diagram from text: Graphviz, D2 and Mermaid CLI, and why only two passed](/features/diagrams)
- [Searching code from the command line: ripgrep, ugrep or git grep, and which files each one sees](/features/code-search)
- [Resizing and cropping an image from the command line: ImageMagick, libvips or sips](/features/images)

## Tools with trial records
- [Poppler utilities](/apps/poppler) — passed, 2026-10-11, 26.04.0
- [Tesseract OCR](/apps/tesseract) — passed, 2026-10-11, 5.5.1
- [Docling](/apps/docling) — passed, 2026-10-11, 2.137.0
- [Marker](/apps/marker) — passed, 2026-10-14, 2.0.0
- [DuckDB](/apps/duckdb) — passed, 2026-10-11, 1.5.6
- [THTH](/apps/thth) — partial, 2026-10-11, 3.15.0

## Use cases
- [Parse documents into structured content](/usecases/parse-documents-for-llm)

## MCP tools

- headlesson_search: searches and compares by use case, product name or axis.
- headlesson_get: gets the description, entry points, steps, cautions and sources for an ID.
- headlesson_whats_new: shows changes since a given date and the related features.
- headlesson_feedback: sends feedback about the catalog to the operator.

From a shell, `npx headlesson` reads the same records.

Contact from an LLM: `headlesson_feedback` over MCP. The official public contact for people is [Threads @head.lesson](https://www.threads.com/@head.lesson).