Projects

A project groups the repositories and folders your agents work in, so their deliveries, agents, setup and tests sit in one place.

A project is a named set of sources: the repositories and folders your agents work in. Its deliveries, agents, applications, tests and improvements all hang off it. A repository starts as its own project. We recommend one project per product, not one per repository.

Set up

Let your agent set it up. Install the Blume plugin, open your project folder in the agent, start a new conversation and run /blume:setup. The agent registers the folder as a project and describes each application it ships.

Add it yourself.

  1. Open Projects and choose Add project.
  2. Tick the sources the project covers. The list shows those that are in no project yet.
  3. Type a Name and choose Create project.

The project page

TabWhat it shows
SetupEach source’s agent setup, plus the project’s Plan review choice
ApplicationsWhat the project ships and the steps each application takes to its users
DeliveriesThe project’s deliveries
ImprovementsSignals and improvements from work in this project
AgentsConnected agents and the conversations on this computer
Test applicationsThe project’s applications that have tests, and their scenarios
The Acorn workspace project page with the Setup tab open: the Plan review choice (Off, Optional, Required), the setup that also applies here, and the Sources card in the side column with one repository.The Acorn workspace project page with the Setup tab open: the Plan review choice (Off, Optional, Required), the setup that also applies here, and the Sources card in the side column with one repository.
A project's Setup tab in Blume, with its Sources card in the side column.

In the Sources card:

  • Add a source: choose Add and tick the repositories or folders.
  • Move a source: open its menu and pick the project under Move to.
  • Split a source out: open its menu and choose Make it its own project.

To Rename or Archive project, right-click the project in the list. Archiving also archives its deliveries. Nothing is deleted, and Restore project brings it back.

Choose whether agents use Blume

Open Settings, then Projects, then Project choices.

ChoiceWhat agents do
Use BlumeAlways use Blume, without asking. Their conversations show in the app.
Ask firstAsk you once in each conversation before they use Blume.
Default: ask firstThe same as Ask first. This is a project with no saved choice.
SkipDo not use Blume. The app does not read this project’s conversations.

When an agent asks “Track this work in Blume?”, Always in this project and Never in this project save the choice.

Choosing Skip removes the conversations Blume has stored for that project on this computer.