Onboarding wizard
On your first launch, Brisal opens the Onboarding wizard before the rest of the app. It sets up the minimum working stack in one pass: a workspace, a Mistral provider, a Mistral Medium 3.5 model, and a default agent.
The wizard is required: it has no skip or close action. The defaults are ready to use, so if they fit your setup, press Done. You can change every choice first.
What to choose
The wizard groups its choices into five sections.
| Section | Choice | What it does |
|---|---|---|
| Workspace | Workspace name | Names the new workspace. Brisal derives its internal id from this name. |
| Provider | Provider and API key | Connects the Mistral template into the workspace. The key is optional; add it now if you want to chat immediately. |
| Model | Model | Adds Mistral Medium 3.5 to the provider. |
| Agent | Select agent and Agent name | Clones either bundled starter agent, using the selected model, and makes the clone the workspace default. |
| Skills | Enable external skills | Allows skills in your personal ~/.agents/skills folder. It starts off. |
The generated ids shown under the workspace, provider, model, and agent fields are derived from the workspace name. If a name would make an invalid id, choose a shorter name using letters, numbers, or hyphens.
The API key is a convenience, not a commitment. Leaving it blank creates the provider without a key; add one later from the provider’s Edit action. See Providers for the editable fields and where Brisal stores keys, and External skills before enabling that separate skill tier.
What happens when you finish
Pressing Done creates the selected setup as one flow. Your new workspace contains the connected provider, its model, and the cloned default agent. Brisal then opens that workspace’s Projects tab, ready for you to create a project and start a session.
The wizard is a one-time setup. After it succeeds, it does not return; later changes belong on the normal Workspaces, Providers, Models, and Agents screens.
API-key reminder
If Brisal cannot save the API key in your operating system’s secure store, it does not discard the rest of the setup. The wizard completes and the provider shows a reminder. Open that provider’s Edit action, enter the key again, and save it. The reminder disappears after Brisal stores the key successfully.
If setup cannot finish
The wizard keeps the values you entered and puts its error beside the affected section. Fix that field and press Done again. Work that already succeeded stays in place, so retrying completes the missing part instead of making a second workspace or duplicate provider.
Continue to your first chat
The wizard prepares the workspace; a project gives your work a home. From the Projects tab, create one, then start a session with the default agent. For the full path, see Getting started.