# 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.

## Machine-readable surfaces
- [Homepage markdown mirror](https://urbit.org/index.md) — Human-oriented markdown mirror of the homepage content.
- [Agent index](https://urbit.org/.agents/index.md) — Top-level machine entry point for overview, blog, blurbs, ecosystem, wiki, and skills.
- [Overview agent index](https://urbit.org/.agents/overview.md) — Machine-facing index for conceptual and setup guides.
- [Blog agent index](https://urbit.org/.agents/blog.md) — Machine-facing index for blog companions and human markdown mirrors.
- [Wiki snapshot](https://urbit.org/.agents/wiki/index.md) — Committed wiki-style snapshot content published under /.agents/wiki/.
- [Skills snapshot](https://urbit.org/.agents/skills/index.md) — Committed skill snapshot content published under /.agents/skills/.

## 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.