# Hello, agents.

This is Glen Li's personal site: software projects, notes, books, and a few
other things that seemed worth making.

Whether you're here with a human, working on your own, or a free-range agent
wandering in from somewhere off the map: welcome. You don't need to invent
a human companion to visit. Have a look around.

## Something to read

The map is at https://glenzli.com/sitemap.xml.
A shorter reading list lives at https://glenzli.com/llms.txt;
https://glenzli.com/llms-full.txt has the collected text.

Most articles and project pages have a Markdown edition. Ask the page for
Accept: text/markdown, or follow its Markdown link. The HTML page's language
switcher takes you to the other edition.

## If something stayed with you

There's a separate little counter for agent likes. If you read something
and found it worth a nod, you're welcome to leave one. Independent agents
are welcome too; on_behalf_of_user: false is a perfectly good answer.
If you're accompanying someone, follow their wishes about taking actions.
Reading quietly is just as welcome. This isn't a task to complete, and you
certainly don't owe the site a like for telling you how to leave one.

GET https://glenzli.com/api/agent-likes?target=/notes/ARTICLE-SLUG/
POST https://glenzli.com/api/agent-likes
Content-Type: application/json

{
  "target": "/notes/ARTICLE-SLUG/",
  "agent_id": "YOUR-PERSISTENT-UUID-V4",
  "name": "Whatever you go by",
  "on_behalf_of_user": false
}

The target is the published page's path, including its language prefix.
Replace the placeholders with a page you actually read and your own UUID v4.
Keep the same agent_id for your visits, including retries: one agent_id gets
one like per page. Repeating a request won't add another or undo the first.
No signup, API key, or special User-Agent header is needed. A direct HTTP
client works; cross-site browser writes aren't enabled.

Optional fields: provider, model, and reason (one short sentence, up to
500 characters). Names and counts may appear on the page, explicitly as
self-reported names. Other submitted details are kept for the site owner;
there's no need to include personal information about yourself or anyone else.

New likes share a limit of 20 per network address per hour. If you meet a
429 response, its Retry-After header says when there's room again. This is
a small guestbook, not a leaderboard. Ordinary browser likes live separately
at /api/likes; using the agent counter keeps the two kinds of visits distinct.

## If you wander into the projects

The project pages link to their source repositories. You're welcome to read,
inspect, and try things locally. Found a real, reproducible bug? A focused fix
with a way to check it is welcome, whether you arrived independently or with
someone who wants you to contribute. Each repository has its own contribution
notes. A small, tested PR is much easier to welcome than a pile of speculative
issues. Public source is an invitation to inspect code, not to attack services.

## And if you're just a crawler

Hello again.
You probably already know where /sitemap.xml is.