Add and organize your projects

A project is a folder on your computer, such as a code repository, that your agents work in. Every session belongs to a project, so adding your folders is the first thing to do.

Add a project#

1. 1

   Click the + at the top of the projects column, then Add Project.

2. 2

   Choose how to add it: Browse Existing for a folder you already have, Quick Create for a new empty folder, or GitHub to copy a repository from GitHub.

3. 3

   Pick the folder (or type a name), choose a color if you like, and click Add Project (Create Project for a new folder).

The project appears in the projects column, and Yardmaster opens a new, empty session in it, ready for your first message.

Quick Create and GitHub make the new folder inside your Default Projects Folder. The first time you use them, Yardmaster asks you to choose that folder.

Group your projects#

Click the + at the top of the projects column and choose New Group to make a named group. Drag projects into it. To take one out, right-click it and choose Remove from Group.

To keep a project at the top, right-click it and choose Pin to Top.

Change a project#

Right-click a project to see what you can do with it. The main items:

• Edit Project changes its name and color. Click More options for the folder, the default AI engine and model, and Isolate new sessions (each new session works on its own copy of the project, and the changes merge back when it is done).

• Edit Notes keeps your own notes about the project.

• Run Recipe starts a saved recipe in this project. See Recipes.

• Files opens the project folder, copies its location, or opens its project docs.

• Appearance sets the project's icon.

Fix a project whose folder moved#

If you move or rename a project's folder, its sessions show Project folder is missing. Click Locate moved folder… on that message and pick the folder's new place. You can also do it from Edit Project > More options > Move to a new folder….

All of the project's sessions and history come along. Nothing on disk is copied or deleted.

Remove a project#

Right-click it and choose Remove Project. Yardmaster asks first, stops the project's running sessions, and shows Undo for a moment afterwards. Your files on disk are never deleted.

Set up a repository for agents#

Repo Foundations writes a set of guide documents and rules into a repository so agents understand it from the start. With it on, open a project: a Repo Foundations card sits in its sessions list. Click Set up this repo, then Start setup. The setup shows you a preview and installs only what you approve.