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.
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
- Start: getting started sets up an organization and your first workspace.
- Install: the
yardCLI and connecting a runner. - Features: docs, prototypes and sheets, notes, files, link blocks, repositories and git, projects and specs, agents, chat, terminals, sheets and context, history, sharing and roles, comments, API keys, storage, feedback, a workspace's feedback, research projects, goals, prototypes, monitors, stats and Insights and apps.
- Tutorials: canvas basics, your first project and pointing an agent at blocks, each with a demo you can try on the page.
- Reference: the API, the CLI and the hotkeys.
- Examples and tips: example uses and prompts and tips.