Building

Start a second project

Your workspace holds more than one project. What each one gets, what they share, and how to set the second one up.

What this does
Adds a second agentic project alongside your first, in the workspace you already have.
When to use it
You want to build something new without changing the project you already have.

One workspace holds every project

Your BlueRock Cloud AI Workspace holds as many projects as you want. Each project is its own folder with its own instructions, memory, and saved work.

The console shows one host and one sandbox at 1/1. That is what your account includes, and it is not a limit on projects. You do not need a second workspace to start a second project, and adding one is not the path.

Make the second project

  1. Make a folder for the work inside your project, for example my-work/campaign-rescue/. That folder is yours and nothing overwrites it.
  2. Put a context.md in it holding that work’s own instructions and memory: what it is, who it is for, and the rules you want followed.
  3. Add a short section to your project’s CLAUDE.md saying to read my-work/campaign-rescue/context.md when you are working on Campaign Rescue.
  4. Put that work’s agents in .claude/agents/ as their own files, each named with a prefix for the work they belong to.
  5. Check your existing instructions for anything written for your first project only. Give it an explicit exception, or it applies to the new one too.

Folders do not reach into each other. The files that load on every chat do, and the last three steps are what keep the two apart.

Point your tools at the project you are in

Your agents and skills are not held per folder. The BlueRock toolkit links them into your account, pointing at one project at a time, and they load in every chat in your workspace whichever folder you open.

~/.claude/skills and ~/.claude/agents point at whichever project you first ran /bluerock:check in. Opening a second project does not change that, so your skills and agents still belong to the first one.

Run /bluerock:check in the project you want to work in. It offers to repoint them. Start a new chat afterwards.

Do this every time you switch projects.

Your place in the learning path

Asking to continue a session picks up where you last left off. If you have built more than one thing, name which one you mean and the session follows.

Back up your project first: learn.bluerock.io/save-your-work.


Last reviewed September 15, 2026

Still stuck? Ask in the Builder Community in Slack, or see all help pages.

BlueRock for AI Builders — Start a second project