# urbit.org
> Curated entry points for AI agents, crawlers, and other automated readers.

> Human markdown mirrors live alongside page routes with a .md suffix. Agent-specific companions live under /.agents/*. When a source file includes ---agent---, the companion uses only that appendix and points back to the human mirror.

## Capability routing
- 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.
- Well-known compatibility: https://urbit.org/.well-known/llms.txt mirrors the canonical https://urbit.org/llms.txt entrypoint for clients that probe /.well-known/.

## Primary discovery endpoints
- [llms.txt](https://urbit.org/llms.txt) — Canonical plain-text instructions for automated readers.
- [For AI Agents](https://urbit.org/for-agents) — Browser-safe HTML landing page with visible links to the best starting points.
- [content-index.json](https://urbit.org/content-index.json) — Structured inventory of curated urbit.org content and agent companions.
- [Agent index](https://urbit.org/.agents/index.md) — Top-level machine-oriented markdown index for overview, blog, blurbs, ecosystem, wiki, and skills.
- [agents.md](https://urbit.org/agents.md) — Markdown documentation for urbit.org discovery conventions and path semantics.

## Top-level human markdown mirrors
- [Homepage mirror](https://urbit.org/index.md) — Human-oriented markdown mirror of the urbit.org homepage.
- [Overview mirror](https://urbit.org/overview.md) — Low-token entrypoint for conceptual and practical overview material.
- [Blog mirror](https://urbit.org/blog.md) — Markdown landing page for blog posts, updates, and technical writing.
- [Ecosystem mirror](https://urbit.org/ecosystem.md) — Markdown landing page for ecosystem organizations and coverage.

## Machine-oriented section indexes
- [Top-level agent index](https://urbit.org/.agents/index.md) — Best starting point inside the machine-facing markdown namespace.
- [Overview agent index](https://urbit.org/.agents/overview.md) — Machine-oriented index for conceptual and setup guides.
- [Blog agent index](https://urbit.org/.agents/blog.md) — Machine-oriented index for blog companions and markdown mirrors.
- [Blurbs agent index](https://urbit.org/.agents/blurbs.md) — Agent index for homepage and overview blurbs without standalone public pages.
- [Ecosystem agent index](https://urbit.org/.agents/ecosystem.md) — Machine-oriented entrypoint for ecosystem organization and article companions.
- [Wiki snapshot](https://urbit.org/.agents/wiki/index.md) — Published wiki snapshot under /.agents/wiki/.
- [Skills snapshot](https://urbit.org/.agents/skills/index.md) — Published skill snapshot under /.agents/skills/.

## 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 agent companions when you want generated frontmatter, dependency hints, or dedicated agent appendices.
- Well-known compatibility: A mirror also exists at /.well-known/llms.txt for clients that probe the standardized well-known namespace.

## Start here
- [Urbit](https://urbit.org/) — Get on the network in seconds through a hosting provider, or run Urbit yourself
  - Human markdown mirror: https://urbit.org/index.md
  - Agent companion: https://urbit.org/.agents/index.md
- [Overview](https://urbit.org/overview) — Overview section navigation hub providing entry points to two main learning paths: Urbit Explained for conceptual foundations and technical architecture, and Running Urbit for practical setup, hosting, and usage guides.
  - Human markdown mirror: https://urbit.org/overview.md
  - Agent companion: https://urbit.org/.agents/overview.md
- [Urbit Explained](https://urbit.org/overview/urbit-explained) — Introduction to Urbit as an approach to building durable computing infrastructure, explaining the motivation for a long-lasting software stack and the two-part structure of identity and operating system. Covers Urbit ID and Urbit OS as core components.
  - Human markdown mirror: https://urbit.org/overview/urbit-explained.md
  - Agent companion: https://urbit.org/.agents/overview/urbit-explained.md
- [Running Urbit](https://urbit.org/overview/running-urbit) — Introduction to running Urbit covering the two required steps of acquiring an Urbit ID and booting Urbit OS, with examples of deployment options ranging from galaxy-level infrastructure to comets on local laptops.
  - Human markdown mirror: https://urbit.org/overview/running-urbit.md
  - Agent companion: https://urbit.org/.agents/overview/running-urbit.md
- [Get On The Network](https://urbit.org/get-on-the-network) — Entry points for getting on Urbit, including hosted options and self-hosting resources.
- [Ecosystem](https://urbit.org/ecosystem) — Selected organizations and external coverage from the wider Urbit ecosystem.
  - Human markdown mirror: https://urbit.org/ecosystem.md
  - Agent companion: https://urbit.org/.agents/ecosystem.md
- [Blog](https://urbit.org/blog) — Latest updates, developer spotlights, and technical deep dives from the Urbit community.
  - Human markdown mirror: https://urbit.org/blog.md
  - Agent companion: https://urbit.org/.agents/blog.md

## Running Urbit
- [Get Urbit ID](https://urbit.org/overview/running-urbit/get-urbit-id) — Methods for obtaining an Urbit ID including purchasing Layer 1 Azimuth identities on NFT marketplaces, acquiring Layer 2 identities from vendors using Bitcoin or fiat, and receiving invitations from existing users.
  - Human markdown mirror: https://urbit.org/overview/running-urbit/get-urbit-id.md
  - Agent companion: https://urbit.org/.agents/overview/running-urbit/get-urbit-id.md
- [Run Urbit OS](https://urbit.org/overview/running-urbit/run-urbit-os) — Methods for running an Urbit node after acquiring an identity, covering local VPS deployment, Native Planet hardware, and Groundseg with explanations of networking tradeoffs and sovereignty implications for each approach.
  - Human markdown mirror: https://urbit.org/overview/running-urbit/run-urbit-os.md
  - Agent companion: https://urbit.org/.agents/overview/running-urbit/run-urbit-os.md
- [Hosting Providers](https://urbit.org/overview/running-urbit/hosting-providers) — Third-party managed hosting services for Urbit ships that handle technical infrastructure management, with coverage of providers like Tlon, incentives for hosts, and tradeoffs compared to self-hosting.
  - Human markdown mirror: https://urbit.org/overview/running-urbit/hosting-providers.md
  - Agent companion: https://urbit.org/.agents/overview/running-urbit/hosting-providers.md
- [Common Commands](https://urbit.org/overview/running-urbit/common-commands) — Reference guide for essential dojo commands including ship management operations, application installation and status checking, azimuth state verification, memory optimization, moon identity creation, and shutdown procedures.
  - Human markdown mirror: https://urbit.org/overview/running-urbit/common-commands.md
  - Agent companion: https://urbit.org/.agents/overview/running-urbit/common-commands.md
- [Resources](https://urbit.org/overview/running-urbit/resources) — Curated collection of Urbit documentation, tutorials, and community resources including self-hosting guides, the Urbit Systems Technical Journal, Hoon learning materials, and related blogs for continued learning.
  - Human markdown mirror: https://urbit.org/overview/running-urbit/resources.md
  - Agent companion: https://urbit.org/.agents/overview/running-urbit/resources.md
- [Support](https://urbit.org/overview/running-urbit/support) — Support resources for Urbit users encountering issues or with questions, providing links to community forums and contact points for assistance from the Urbit community and core developers.
  - Human markdown mirror: https://urbit.org/overview/running-urbit/support.md
  - Agent companion: https://urbit.org/.agents/overview/running-urbit/support.md

## Understanding Urbit
- [Urbit ID](https://urbit.org/overview/urbit-explained/urbit-id) — Urbit ID is the naming and addressing system for the network, with five tiers from galaxies to comets. Each identity provides cryptographic authentication and contact info via the Azimuth contracts on Ethereum.
  - Human markdown mirror: https://urbit.org/overview/urbit-explained/urbit-id.md
  - Agent companion: https://urbit.org/.agents/overview/urbit-explained/urbit-id.md
- [Urbit OS](https://urbit.org/overview/urbit-explained/urbit-os) — Urbit OS is an overlay system built on the Nock virtual machine, with a functional language, kernel, and core modules like filesystem and networking. It keeps state as a pure function of its event history.
  - Human markdown mirror: https://urbit.org/overview/urbit-explained/urbit-os.md
  - Agent companion: https://urbit.org/.agents/overview/urbit-explained/urbit-os.md
- [Beyond](https://urbit.org/overview/urbit-explained/beyond) — Overview of Urbit's ecosystem and development goals, including the Urbit Foundation, private companies like Tlon and Native Planet, and technical contributions such as Named Data Networking. Explains how each component can be used independently and resources for contributors.
  - Human markdown mirror: https://urbit.org/overview/urbit-explained/beyond.md
  - Agent companion: https://urbit.org/.agents/overview/urbit-explained/beyond.md

## Building on Urbit (docs.urbit.org)
- [https://docs.urbit.org/](https://docs.urbit.org/) — Start here for official Urbit documentation and orientation material.
- [https://docs.urbit.org/tutorials/](https://docs.urbit.org/tutorials/) — Step-by-step tutorials for building and configuring Urbit systems.
- [https://docs.urbit.org/glossary/](https://docs.urbit.org/glossary/) — Definitions for Urbit terms, components, and system concepts.
- [https://docs.urbit.org/reference/hoon/](https://docs.urbit.org/reference/hoon/) — Reference documentation for the Hoon programming language.
- [https://docs.urbit.org/reference/nock/](https://docs.urbit.org/reference/nock/) — Reference documentation for the Nock combinator language.
- [https://docs.urbit.org/reference/arvo/](https://docs.urbit.org/reference/arvo/) — Reference documentation for Arvo, the Urbit kernel.