Jekyll2026-09-07T15:23:41+00:00http://saintx.dev/feed.xmlAlexander Saint CroixNotes on agents, context, and tools.Traverse context without ingesting it.2026-09-07T00:00:00+00:002026-09-07T00:00:00+00:00http://saintx.dev/2026/09/07/surf-introI published my surf tool. Source is at https://github.com/saintx/surf-cli

How it works

Instead of reading a markdown file into context, use surf to list its H1-H6 heading structure:

% surf README.md
- surf
  - When to use
  - Addressing
  - Agent skill
  - Install
    - Nix
  - Releasing
  - Development
  - Tests

Then, read only the part you’re interested in:

% surf README.md "When to use"
## When to use

Invoke when skimming markdown, TeX, or PDF files, checking what a file contains,
listing structure, extracting a named address, or batch-scanning metadata across
a directory. See `surf --help` for CLI flags. Skip when the full body is already
needed. ...
]]>