# Your first workspace

> Create a workspace for a project folder, or open the ready-made demo and Launch day workspaces to look around first.

Source: https://docs.neurosquad.ai/en/getting-started/first-workspace

A **workspace** is a project folder. Every agent in it starts in that folder, so it already knows
what "the code" means.

## Look around the demo first

On a brand-new installation NeuroSquad creates a small **NeuroSquad demo** workspace: a **Lead**
Claude Code agent already wired to a terminal, a **Start here** note and a **Try these** todo list,
plus a task board and a note that explains how arrows work. A first prompt is typed into the agent,
waiting for you to press Enter. It lives in a scratch folder — nothing of yours is touched. If you
delete it and want it back, the empty canvas has a button to open it again.

## See everything at once: "Launch day"

Want to see a full setup? Open **What's new** at the bottom of the sidebar and press **Open Launch
day**. You get a small online shop getting ready for a launch, laid out in five framed chapters:

- **Start here** — a sticky, a guide note and a todo-list tour.
- **Build squad** — three Claude Code agents (**Lead**, **Frontend**, **Backend**) and a task board
whose tasks are already assigned to them. Press **Start** to begin.
- **Dev tools** — a dev server terminal, a browser and a dev servers card.
- **Business desk** — notes, a Telegram bot card and a reference card with mockups.
- **Mission control** — standup, budget, a web watch and a flow timer.

Like the demo, it lives in a scratch folder. Deleting it costs nothing.

## Create a workspace

**1. Press + next to Workspaces in the sidebar**

The **Create workspace** dialog opens.

**2. Give it a name**

Something meaningful to you — "Online shop", "Blog", "Client X".

**3. Choose the project folder**

Press **Browse…** and pick the folder with your project. Agents will work there.

**4. Pick an accent colour (optional)**

Handy once you have several workspaces — it marks the workspace in the sidebar.

> Deleting a workspace only removes it from NeuroSquad. The folder and your files stay exactly where
> they are.

## Optional extras

If your agents will work in [isolated worktrees](https://docs.neurosquad.ai/en/agents/worktrees), the workspace's edit dialog also
lets you add a **setup command** (for example, installing dependencies), **files to copy** into each
new worktree (like `.env`), and a **run command** that starts your project and opens it in a browser
card. The same dialog holds the [instructions file](https://docs.neurosquad.ai/en/agents/instructions) mirror.

## Next

  - **[Your first agent](https://docs.neurosquad.ai/en/getting-started/first-agent)**: Add an agent and send it a prompt.
