Yard Docs
Sign in
On this page

Getting started

Sign up, set up an organization, invite your team and open your first workspace in Yard.

Updated November 7, 2026 · 5 min read

Create an account

Go to Sign up and enter your name, email address and a password (at least 10 characters), or sign up with GitHub. Confirm the address with the code Yard emails you. If someone invited you, open the link in their invitation instead: after you confirm your address you join their organization straight away. When the invitation was sent to one address, the signup form fills it in for you.

A new account is then shown two steps once: how Yard looks, and what the agent reads when nothing is selected. Choose, or press Skip setup; both are in Account settings afterwards. See account preferences.

Yard may be in early access: the sign-up form then says Join early access, and after you confirm your address you see "You're on the early access list" until the Yard team lets you in; Check again looks whether you are in yet. You get an email when you are. An invitation skips the wait.

Set up your organization

The first time you sign in, Yard walks you through five steps. Every one of them can be changed later in Settings.

  1. Organization: its name and the address it lives at (useyard.app/<your-org>).
  2. GitHub: install the Yard GitHub App on the account that owns your repositories. You can skip this and do it later under Settings, Repositories.
  3. Storage: where workspace files are backed up (Cloudflare R2, Amazon S3 or storage Yard manages) and how long deleted projects and archived workspaces are kept. Bucket credentials are entered later under Settings, Storage & git.
  4. Models: connect an agent. Agents run with each person's own account, inside containers: sign in to the one you use (Claude Code, Codex or Cursor); teammates connect theirs under Account settings, Agents.
  5. Invite team: send invitations by email or copy an invite link.

Connect a runner

A workspace needs a runner: the machine where its files, containers and agents live. An organization admin registers one from the Runners menu in the organisation's top bar. Yard shows a one-line command with a token to run on the machine; once it connects, the runner shows as online and new workspaces can use it. If the machine already runs a runner, the same dialog also gives a command that adds your organization to it instead of installing a second one. Connect a runner has the details.

Open a workspace

From the workspace switcher at the top of the sidebar, which lists each workspace with how many open projects it has ("3 active projects") and its repositories, choose New workspace, give it a name, pick the runner it lives on (and whether it may use the runner's GPU) and, when the organization has several, the storage bucket.

Your first workspace

A new workspace opens on three things: A machine where the agents run, An agent (your Claude, Codex or Cursor account) and Your repositories, which are the only ones agents work in. A done row says what it is; the next open one has the filled button. Not now goes straight to Home.

Home then asks What needs doing? Describe it, paste an error, or drag in anything you are reading, pick what it starts as (a project or a prototype, for example) and whether to write a spec first, and choose Start or Create empty. Type / for the rest. Under the box, Pick up where you left off lists what waits for you, your open tabs and what you opened lately.

Finding your way

One sidebar and the open tabs above the work are the frame. A tab you only pass through, shown in italics, gives way to the next place you open. To keep it, click its row or tab again, double-click it, or write in it.

  • The workspace switcher and search (⌘K) are at the top. The switcher also shows the runner and its state.
  • The context box above New project gathers what you drag into it from anywhere: docs, prototypes, repositories, pull requests, branches, issues, files. It shows while you drag, even empty. Its menu starts a project with it, attaches it to a project or doc, pins it all or clears it, and its grip drags all of it at once (into a doc it becomes one group of references).
  • New (⌘J) opens the composer on Home, with your context in it.
  • The places: Home (one composer, everything that needs you, and your recent files), Projects, Goals, Files (every doc, prototype, sheet, repository and upload in one list) and Search (⌘K).
  • Under them:
    • Active lists the open projects, each with its state in a word (asks, working, ready, draft), and All N projects under them.
    • Pinned folds to its count; drag anything onto it to pin it.
    • Resources has a folder each for Docs, Prototypes, Sheets and Repos, and Research when there is some, each with its count. Click a folder to unfold its rows; its + makes a new one (or connects a repository). Opening something unfolds its folder, and this browser remembers which folders are open. Rows drag into the composer, onto Pinned or onto a project. A repository shows the branch the workspace reads; clicking it opens its page.
    • Runs has Monitors and Apps.
  • At the foot, Workspace settings and More in workspace (⋯), which holds Manage repositories, Monitors, Insights, Apps, Feedback, History, making a doc or a sheet, Customize sidebar, People and Settings.
  • The account row has your menu, theme and notifications.

Tabs reopen where you left them, with the selection and unsent text, per person and browser. Drag a row, tab or chip onto a chat, tab, the context box or a sidebar project to attach it; a target says what a drop will do.

A project has its work on the left and its chat on the right. The work is Changes, Context, Plan, Screens, Docs, Canvas, Files, Apps, Terminal and Crew, each when it applies. One button says the next step. On a phone the sidebar is a drawer, tabs scroll, and a switch moves between work and chat.

Invite is under More → People and in a doc's header.

Was this page useful?
Edit this page