llms.txt
# Hraness
> Tools for agents and humans. Hraness is Ben Guo's software studio in Puerto Rico. Most of its tools for AI agents and for people are open source.
When to use this site:
- Use hraness.com to learn what Hraness is, what it is building, and what its founder Ben Guo is writing now.
- Use /kb/evaluation for the frozen 2 August 2026 KB retrieval pilot metrics.
- Use /prompting for what predicts whether Ben Guo starts a Codex, Claude Code, or Devin session on a frontier model, read twice from his local stores, and the ALGAL router kept in step with the picks.
- Use /direct for Direct gives browser agents repeatable app states that open by URL, with your real interface running on fixture data.
- Use /sponge for public notes on Sponge, including an illustrated summary of how it works.
- Use /stripe for a sourced history of Stripe. It is company history, not Stripe API documentation.
- Use /eds for the EDS Research Index, a sourced index of Ehlers-Danlos syndromes research for patients and clinicians. It is not medical advice.
- Use the writing, projects, and reading collection pages to browse essays, software, and reading notes. Do not treat this site as a public HTTP API, OAuth provider, GraphQL endpoint, MCP server, or store.
- Use /portfolio.json when you need the portfolio as data: project identity, shared foundations, typed relationships, and marketing copy. It is a generated static document, not a query API.
Public HTML pages also serve Markdown for `Accept: text/markdown`. Sibling `.md` URLs are the same representation. A few writing posts exist only as HTML, and their entries below link the HTML page. `/llms.txt` covers this origin.
## Pages
- [hraness](https://hraness.com/index.md): Hraness index: the organization statement, projects, Ben Guo's about section, reading, writing, and social.
- [kb evaluation](https://hraness.com/kb/evaluation.md): In a 2 August 2026 pilot with 18 frozen questions over 155 notes, exact and hybrid KB retrieval tied on held-out Recall@10 (0.833333).
- [direct](https://hraness.com/direct.md): Direct gives browser agents repeatable app states that open by URL, with your real interface running on fixture data.
- [introducing direct](https://hraness.com/direct/introducing): Open any state of your web app from a link. Direct gives each screen a named scenario with sample data, runs your real interface against it, and tells tests and coding agents when the page has settled.
- [Stripe history](https://hraness.com/stripe/llms.txt): Timeline, category, valuation, payment-volume, appearance, and public-data guidance.
- [EDS Research Index](https://hraness.com/eds/llms.txt): Ehlers-Danlos research records with linked sources, labeled by kind of evidence, EDS type, and diagnostic criteria.
- [fiction](https://hraness.com/fiction.md): An original speculative chronicle.
- [bookshelf](https://hraness.com/bookshelf.md): Books Ben is reading, with notes.
- [movie shelf](https://hraness.com/movie-shelf.md): Movies Ben has watched, with notes.
- [writing](https://hraness.com/writing.md): Ben Guo on coding agents, music, and Puerto Rico, with reviews of his Mac apps and desk gear. Pieces Hraness drafted with AI are marked.
- [projects](https://hraness.com/projects.md): independent products, research, and open-source software from Hraness, grouped by pack.
- [social](https://hraness.com/social.md): Find Hraness on Substack, X, Instagram, LinkedIn, and other social platforms.
- [when Ben Guo picks a frontier model](https://hraness.com/prompting.md): What predicts whether Ben Guo starts a Codex, Claude Code, or Devin session on a frontier model, read twice from his local stores, and the ALGAL router kept in step with the picks.
- [lecturas](https://hraness.com/es/reading.md): selección del archivo de lectura de Hraness: páginas traducidas al español y entradas destacadas en inglés.
- [la inteligencia artificial ya supera a algunos de los mejores pronosticadores humanos](https://hraness.com/es/reading/artificial-intelligence-now-beats-some-of-the-best-human-forecasters.md): The Economist informa sobre la primera victoria de una IA en la Copa Metaculus y el acercamiento de los LLM a la paridad con los superpronosticadores.
- [la forma de las cosas por venir, parte 1: el thunderdome continuo](https://hraness.com/es/reading/the-shape-of-things-to-come.md): Steve Yegge relata seis semanas construyendo Wheelhouse y por qué el trabajo con agentes a escala empieza a parecerse a una ciudad.
- [preentrenamiento mediante autojuego con cero datos](https://hraness.com/es/reading/self-play-pretraining-with-zero-data.md): Cowsik, Dolev, Li y coautores muestran que el autojuego sobre una máquina de Turing universal preentrena sin datos naturales y con escala predecible.
- [die Form der kommenden Dinge, Teil 1: das kontinuierliche Thunderdome](https://hraness.com/de/reading/the-shape-of-things-to-come.md): Steve Yegge berichtet von sechs Wochen Bau an Wheelhouse und warum agentische Arbeit im großen Maßstab einer Stadt gleicht.
- [Git in jedem Maßstab](https://hraness.com/de/reading/git-at-any-scale.md): Vicent Martí erklärt, wie Cursors Continuity Git-Hosting mit einem Write-Ahead-Log in S3 und lokalen Replikaten skaliert.
- [ein schnellerer Algorithmus für kürzeste Wege](https://hraness.com/de/reading/a-faster-shortest-path-algorithm.md): Geby Jaff beschreibt, wie zehn Claude-Agenten den formal geprüften Kürzeste-Wege-Algorithmus C-HD hervorbrachten.
- [el bucle del manager](https://hraness.com/es/writing/the-manager-loop.md): Un agente sostiene el plan, otro sostiene el trabajo y una superficie de progreso se interpone entre ambos. De dónde viene, qué arregla y cómo falla.
- [construyendo una fábrica de software](https://hraness.com/es/writing/building-a-software-factory.md): He estado construyendo una fábrica de software con 15 suscripciones de Codex, trabajando en una docena de proyectos durante el último mes.
- [reading](https://hraness.com/reading.md): Notes on articles, books, talks, and posts Ben Guo has saved, each linked to its source. Permalinks live at `/reading/{slug}`.
- [sponge](https://hraness.com/sponge.md): Index of public Sponge notes and working documents.
- [Sponge summary](https://hraness.com/sponge/summary.md): Research reports are fast to produce with AI, but still costly to trust, reuse, and update. Sponge lets agents autonomously absorb their claims, evidence, and context into structured knowledge while people steer, review, and control release.
## Writing
- [state of local ai, oct 2026](https://hraness.com/writing/state-of-local-ai-oct-2026): On-device models for Mac, Windows, Linux, iOS, and Android: vision, tool calls, speech, embeddings, media, translation, and decisions, with a pick per task.
- [a love letter to typing code by hand](https://hraness.com/writing/a-love-letter-to-typing-code-by-hand): I remote into my dark factory, a laptop that sits at home in Puerto Rico on my desk.
- [september agent velocity report](https://hraness.com/velocity-sep26): Thirty days of agent token usage and global portfolio code activity, aligned by local hour.
- [my girlfriend thinks i have ai psychosis](https://hraness.com/writing/my-girlfriend-thinks-i-have-ai-psychosis.md): My current projects, from hotrodding harnesses to enabling agent civilizations.
- [fluidvoice vs wispr flow: local dictation won me over](https://hraness.com/writing/fluidvoice-vs-wispr-flow.md): FluidVoice matches Wispr Flow for me while keeping models local and the core open. Here is where the Mac app wins and the hosted service stays easier.
- [how i use duet display to reach two macs from an ipad](https://hraness.com/writing/duet-display-remote-access-ipad.md): I use Duet Display to reach two coding laptops from an iPad and keyboard. It occupies a useful middle ground between Sidecar and a dedicated remote desktop.
- [kitetasks gives google tasks the mac app it needs](https://hraness.com/writing/google-tasks-mac-kitetasks.md): Google Tasks already has the calendar, web, mobile, and widget behavior I need. KiteTasks adds the missing native Mac client without replacing the system.
- [periscope vs tailscale for a home vpn](https://hraness.com/writing/periscope-vs-tailscale.md): Periscope routes traffic through my home connection; Tailscale builds a broader private network. Here is how both differ from remote desktop.
- [why granola is still my ai meeting notes app](https://hraness.com/writing/granola-ai-meeting-notes.md): Granola's calendar and menu-bar loop keeps it sticky for me, despite my preference for local transcription. It starts deliberately, not as a hidden recorder.
- [beeper finally gave me one inbox for every messenger](https://hraness.com/writing/beeper-unified-inbox.md): Beeper unifies the messaging networks I miss, then adds a CLI and MCP for bounded agent workflows. That combination changed my inbox and my tools.
- [atlas for mac is my local visual bookmark library](https://hraness.com/writing/atlas-for-mac-review.md): Atlas is a fast local visual library with grid, canvas, and infinite views. It lets me collect inspiration without turning the collection into a social feed.
- [why i still use arc on desktop, but chrome on iphone](https://hraness.com/writing/arc-browser-review.md): Arc organizes my desktop browsing better than Chrome, but Arc Search's incomplete return sync keeps Chrome on my phone. Safari remains tempting on iOS.
- [amphetamine vs caffeinate for keeping a mac awake](https://hraness.com/writing/amphetamine-vs-caffeinate.md): Amphetamine makes keep-awake state visible in the menu bar; macOS caffeinate is better for scripts. I use the app for long-running coding-agent laptops.
- [why i use an apple magic trackpad instead of a mouse](https://hraness.com/writing/apple-magic-trackpad-review.md): A Magic Trackpad feels more familiar than a mouse after years on laptops. Gestures and continuity win; precision and wrist comfort remain personal.
- [lofree flow lite fits how i type now](https://hraness.com/writing/lofree-flow-lite-review.md): The Lofree Flow Lite's quiet, padded feel suits a workflow with much more dictation and less all-day typing. My old split keyboard solved another problem.
- [caldigit element 5 is the desk hub i wanted](https://hraness.com/writing/caldigit-element-5-review.md): The Element 5 gives my desk four Thunderbolt 5 ports, five fast USB ports, and 90W host charging in a compact aluminum hub. Its restraint is the point.
- [i use an owc envoy ultra for time machine](https://hraness.com/writing/owc-envoy-ultra-time-machine.md): My Envoy Ultra is a fast, rugged Thunderbolt 5 SSD, but Time Machine automation is why it matters. Local versioned backup is useful because it is boring.
- [teenage engineering ob–4 is my desk speaker](https://hraness.com/writing/teenage-engineering-ob-4-review.md): The OB–4 is compact enough to move and powerful enough for my desk. Bluetooth, line input, FM, and its tape controls make it more than a generic speaker.
- [why i still use the original arturia keystep 37](https://hraness.com/writing/arturia-keystep-37-review.md): The original KeyStep 37 gives me the keybed, sequencer, MIDI, and CV workflow I want. The mk2 is a stronger new buy, not an automatic upgrade.
- [akg k371 is my compact monitoring headphone](https://hraness.com/writing/akg-k371-review.md): The AKG K371 is affordable, closed-back, foldable, light enough for long sessions, and compact enough to travel. It is my private monitoring middle ground.
- [my girlfriend asked me why i have 15 codex subscriptions](https://hraness.com/writing/my-girlfriend-asked-me-why-i-have): I have 15 Codex Pro 20x subscriptions.
- [building a software factory](https://hraness.com/writing/building-a-software-factory): I’ve been building a software factory with 15 Codex subscriptions, working across a dozen software projects over the last month.
- [3 lessons for founders from my time at zo computer](https://hraness.com/writing/3-lessons-for-founders-from-my-time): what I learned building at the frontier.
- [harnessing puerto rico](https://hraness.com/writing/harnessing-puerto-rico): on agent harnesses, puerto rico, the Way of Hra, and making music again.
- [computronium](https://hraness.com/writing/computronium): on vibe computing, abstraction, and virtual living matter.
- [coding as music](https://hraness.com/writing/coding-as-music): on ai enabled coding, making music, and discovering what was already there.
- [a home for the mind](https://hraness.com/writing/a-home-for-the-mind): on architecture, malleable software, and a shell worth living in.
- [life and llms](https://hraness.com/writing/life-and-llms): on synchronicity, improvisation, and the magic of making things up well.
- [the future of software](https://hraness.com/writing/the-future-of-software): on legalese, pattern languages, transparency, and machine-generated code.
- [what is an agent harness?](https://hraness.com/writing/what-is-an-agent-harness): The program around the model: context, tools, loop, session, and translation. Why benchmarks name it, and how ALGAL makes it a value you can replay and grow.
- [relationships](https://hraness.com/writing/the-relationships-pack): The Relationships pack brings together contact management, reviewed signed-in capture, and source-cited dossiers.
- [knowledge](https://hraness.com/writing/the-knowledge-pack): The Knowledge pack covers cited notes, memory with sources, and a daily news page that explains its rankings.
- [media](https://hraness.com/writing/the-media-pack): icon.place and Textmock cover icons and fictional conversations; the icon.place drawing lab records model proposals through ALGAL.
- [tools for token maximalists](https://hraness.com/writing/tools-for-token-maximalists): Tools for Token Maximalists brings together agent routing and session compaction.
- [the manager loop](https://hraness.com/writing/the-manager-loop): One agent holds the plan, another holds the work, and a progress surface sits between them. Where it came from, what it fixes, and how it fails.
- [ra-ness](https://hraness.com/writing/ra-ness): To be like Ra, to harness Ra-ness, make Creation a daily practice.
## Optional
- [sitemap](https://hraness.com/sitemap.xml): Indexable HTML URLs.
- [writing atom](https://hraness.com/writing/atom.xml): First-party writing feed.
- [reading atom](https://hraness.com/reading/atom.xml): Reading notes, newest first.
- [portfolio.json](https://hraness.com/portfolio.json): Machine-readable portfolio: active projects, product packs, shared foundations, typed relationships, and canonical product copy, generated from the Hraness registries.
- Reading notes live at `/reading/{slug}` and have Markdown representations. Start from `/reading`.
