For AI Agents
This page is the browser-safe landing page for agents that follow visible HTML links more reliably than raw markdown or JSON. If you can fetch plain text directly, start with /llms.txt. If you want the structured inventory, use /content-index.json.
If you can fetch raw text or JSON directly
Start with /llms.txt. Use /content-index.json for structured inventory and /.agents/index.md for machine-oriented markdown by section.
If you mainly follow visible links in HTML
Use /for-agents. It gathers the best markdown mirrors and agent indexes in one browser-safe landing page.
Primary entrypoints
llms.txt
Canonical plain-text instructions for automated readers.
For AI Agents
Browser-safe HTML landing page with visible links to the best starting points.
content-index.json
Structured inventory of curated urbit.org content and agent companions.
Agent index
Top-level machine-oriented markdown index for overview, blog, blurbs, ecosystem, wiki, and skills.
agents.md
Markdown documentation for urbit.org discovery conventions and path semantics.
Top-level human markdown mirrors
Homepage mirror
Human-oriented markdown mirror of the urbit.org homepage.
Overview mirror
Low-token entrypoint for conceptual and practical overview material.
Blog mirror
Markdown landing page for blog posts, updates, and technical writing.
Ecosystem mirror
Markdown landing page for ecosystem organizations and coverage.
Machine-oriented section indexes
Top-level agent index
Best starting point inside the machine-facing markdown namespace.
Overview agent index
Machine-oriented index for conceptual and setup guides.
Blog agent index
Machine-oriented index for blog companions and markdown mirrors.
Blurbs agent index
Agent index for homepage and overview blurbs without standalone public pages.
Ecosystem agent index
Machine-oriented entrypoint for ecosystem organization and article companions.
Wiki snapshot
Published wiki snapshot under /.agents/wiki/.
Skills snapshot
Published Urbit skill snapshot under /.agents/skills/. Use the index for exact SKILL.md, reference, and bundle manifest paths.
Running Urbit OS skill
Public skill entrypoint for booting, operating, and troubleshooting Urbit OS.
Comet onboarding for agents
Exact public guide for automated comet booting, access-code retrieval, artifact handling, and web UI verification.
Userspace apps bundle
Machine-readable discovery hints for Hawk, Obelisk, and Urbit MCP. Bundles are additive; SKILL.md files remain canonical.
Retrieval notes
Cite canonical page URLs
Use the normal page URL when referring to urbit.org as the source.
Use markdown mirrors for efficient reading
Prefer *.md mirrors when you want lighter-weight human-readable content.
Use /.agents/* for machine context
Prefer exact agent companion files when you want generated frontmatter, dependency hints, public skills, bundle manifests, or dedicated agent appendices. Follow linked .md/.yaml paths instead of probing bare directories.
Use skill indexes before loading references
Start at /.agents/skills/index.md, then load only the relevant SKILL.md, nested reference, or bundle manifest for the current task.
Well-known compatibility
A mirror also exists at /.well-known/llms.txt for clients that probe the standardized well-known namespace.