Creating a Workspace
A workspace is your project environment — it connects a GitHub repository to an AI agent and gives you a persistent place to work on a customer deployment. Each customer engagement should have its own workspace.
Go to Dashboard → New Workspace to open the creation wizard.
Step 1 — Project info
| Field | What to enter |
|---|---|
| Workspace name | A clear name for this engagement (e.g. "Acme Corp — Main Campus") |
| Client name | The customer name — used for labelling and repository naming |
| Description | Optional notes about the scope or special requirements |
| Base template | The PIAM template to use as the starting point |
| Attach to existing repo | Check this only if you want to work directly on a shared repository rather than creating an isolated fork |
Fork vs attach — which to choose?
Fork mode (default, recommended) creates a brand new GitHub repository exclusively for this workspace, copied from the selected base template. Changes you make are completely isolated from the template and from other customer workspaces.
Attach mode connects the workspace directly to the base repository without creating a copy. Any changes you make affect the shared repository immediately. Use this only when you intentionally want multiple developers working on the same repository, or when connecting to an already-existing customer repo.
Step 2 — AI provider
| Field | What to enter |
|---|---|
| AI provider | Anthropic, OpenAI, Google, Groq, or Together |
| Model | The specific model to use (populated from your Model Library) |
| API key | Leave blank to use your global key from Settings → Model Library |
| Agent type | Interactive (live session) or one-off (autonomous run) |
If you haven't added any API keys yet, go to Settings → Model Library first.
Step 3 — Server configuration
Optional. Fill in if you want the workspace to be able to deploy directly to a customer server.
You can leave this blank and configure it later from Workspace Settings.
Step 4 — Review and create
A summary of your selections. Click Create workspace to start initialisation.
What happens during initialisation:
- A new GitHub repository is created and set up (fork mode) or the existing repo is cloned (attach mode)
- The workspace is registered in the platform
- If sandboxes are enabled: a dedicated microVM is provisioned and the repository is cloned inside it
Initialisation typically takes 30–90 seconds. You can watch progress on the initialisation screen. Once complete, the workspace appears on your Dashboard as a card.
After creation
Click the workspace card on the Dashboard to open it. The workspace opens with a chat interface connected to your chosen AI agent.
You can always change the AI model from Workspace Settings — you do not need to recreate the workspace to switch models.