Docs / Resources

Resources

The source, the schema, and where to go if something is wrong.

The registry

Every claimed name is a JSON file in a public GitHub repo. There is no hidden database: what you see in the repo is what resolves.

preetmendpara/runs-at.dev · the registry, the app, and this site
domains/ · every claimed record, one file per name

The schema

What CI actually checks on every pull request. See the record reference for the readable version.

lib/schema.js · validateRecord, the source of truth
schema/record.schema.json · the JSON Schema mirror

For machines and agents

Everything an agent or script needs is a plain file or a JSON endpoint. SendAccept: text/markdown on any page of this site and you get the agent index as markdown instead of HTML.

/openapi.json · the full API spec: every endpoint, typed, with auth scopes
/.well-known/mcp · MCP server (JSON-RPC): check_name, get_record
/llms.txt · agent index: when to use this site, how to claim and deploy
/sitemap.xml · every page
/docs/records · the record format the API writes

Report abuse

If a subdomain is phishing, impersonating someone, or serving malware, email abuse@runs-at.dev and it will be reclaimed.

Policy

What names cost, what forfeits one, and what happens if runs-at.dev shuts down.

Policy