Skip to content

Add a project

A project is a folder you work in. Every agent belongs to one. You add projects on the Mac; your iPhone and iPad show the same list.

One project is there already: chat, which each host makes at ~/.agents/chat for chats that need no project. See Chat without a project.

Before you start

  • At least one runtime installed on this Mac. If the list says No agent runtime found, install one first; see Runtimes for what each needs.
  • To clone, the Git address of the repository, and access to it from this Mac (the same access git clone would need in Terminal).

Steps

Add a folder that is already on your Mac

  1. Choose File ▸ Add Project… (⌘O). With no projects yet, you can click Add Project… in the list instead.
  2. Pick the folder and click Open.

The project appears in the list, named after the folder, and its page opens beside it.

Clone a repository

  1. Copy the repository's HTTPS or SSH address, such as https://github.com/example/repo.git.
  2. Choose File ▸ Clone Project from Git URL… (⇧⌘O). With no projects yet, click Clone Project from Git URL… instead.

The sheet Clone a Git repository opens with the address you copied already in it. Under the address it says where the clone will go, for example Clones into ~/repo and adds it as a project. 3. Click Clone.

The sheet closes at once. The project appears in the list with Cloning… under its name while it downloads, then becomes an ordinary project.

If you have added a server, the + menu has This Mac and one entry per server; pick where the project should live first. See Add a server.

Archive a project you are done with

  1. Stop any agent in the project that is still working. See Stop and archive agents.
  2. Right-click the project in the list and choose Archive.

The project moves under Archived at the bottom of the list, with when you archived it. Its folder, its agents and their conversations are kept, and its workflows stop running until it comes back. 3. To bring it back, open Archived and click Bring Back beside the project.

The chat project can be archived too. It stays archived until you bring it back, and New Chat offers to.

There is no separate way to remove a project: archive it, and delete the folder in Finder if you no longer want it. Show in Finder on the same menu takes you there.

If it doesn't work

  • Stop these first: followed by agent names means those agents are still working. Stop them, then archive again.
  • That is not a Git URL this app can clone. The address is not one Git understands. Paste the HTTPS or SSH address from the repository's Clone button.
  • Folder is missing under a project's name means the folder was moved or deleted outside the app. Put it back, or archive the project.

See also