Yard Docs
Sign in
On this page

What Yard is

Yard is a shared workspace for a product team, with coding agents that work in their own containers and leave pull requests to review.

Updated November 2, 2026 ยท 3 min read

Yard is a shared workspace for everyone working on a product. Each workspace holds docs where people gather notes, images, files, links and repositories, and edit them together in real time. When a piece of it is ready to build, you pick what describes it, say what you want and choose what comes back: a project whose coding agent gets that context, works in its own container and ends with pull requests for someone to review, a spec to edit first, a prototype, or a research project that answers a question in a doc of its own.

The parts

  • Organizations hold people, settings, runners and storage. You belong to one or more and switch between them from the top of the sidebar.
  • Workspaces live inside an organization. Each one has its own docs, prototypes, projects, sheets, files, history and members.
  • Docs are the pages of a workspace: text with blocks placed in it, which gather what a piece of work needs.
  • Blocks are what sits in a doc or on a sheet: notes, images, files, links, repositories and projects.
  • Projects are pieces of work handed to an agent. A project starts from a spec (a note describing the goal and its acceptance criteria), runs in its own container with a worktree of each repository on its own branch, and finishes with a push and pull requests.
  • Runners are the machines that do the work: a server, a cloud VM or a desktop with a GPU you register, or one Yard provides. Files, containers, terminals and agents live on the runner; the website and the API never run your code.
  • Agents are Claude Code, Codex and Cursor, with Grok as Experimental. Each person signs in with their own account, and agents only ever run inside containers.

What makes it different

  • Everything is files with history. Docs, sheets, specs, notes and uploads are files under git on the runner. You can see who changed what and revert anything.
  • Your machines, your storage. Register your own runners and keep files in your own Cloudflare R2, Amazon S3 or Google Cloud Storage bucket.
  • Agents never push. You push branches and open, review and merge pull requests from Yard, and they are made as you.
  • Agents ask when they are missing context. Questions show up in the project's chat as a short form, and the person who started the work is told.

Where to go next

Was this page useful?
Edit this page