# First-run setup

Foxora Desktop v5.0.3 uses a short four-step personalization flow. It asks what you do, what you want Foxora to help with, how much autonomy new tasks should inherit, and how the voice agent should address you.

The web app does not show this Desktop setup flow. After web sign-in, it opens the workspace directly.

## Before you start

- Install Foxora Desktop and complete browser sign-in.
- Keep an internet connection available while Foxora loads the account and local runtime.
- Treat role and goal answers as personalization, not permissions. They influence suggestions but do not limit the product.

## 1. Choose your role

On **What best describes your work?**, choose Developer, Founder, Product / PM, Designer, Marketer, Data / Analyst, Writer, or Something else, then select **Continue**.

Foxora uses this answer with your goals to prioritize useful agents, skills, recipes, and starter actions.

## 2. Choose your goals

On **What do you want to do with Foxora?**, select every relevant outcome. The current choices cover building software, automation, research, data analysis, content and design, business operations, web tasks, and learning.

Select **Continue** after checking the list. These choices do not prevent you from using other workflows later.

## 3. Set the default autonomy

On **How hands-on should agents be?**, choose the default for new tasks:

| Onboarding choice | Composer mode | Behavior |
| --- | --- | --- |
| Ask first | Ask Permissions | Requests approval before each file edit and command. |
| Auto-approve edits | Accept Edits | Applies routine edits while keeping riskier commands gated. |
| Autopilot | Auto mode | Runs a bounded task end to end without routine approval stops. |

The onboarding screen initially selects **Ask first**. After onboarding, each new task inherits the saved machine-level default until you change it from the composer.

> **Bypass Permissions is not an onboarding option.** It remains available in the composer for trusted, recoverable environments, but should not be the normal first-run choice.

## 4. Configure the voice agent

If voice is available for the account, choose:

1. The agent name shown in voice interactions.
2. The voice used for spoken replies.
3. What the agent should call you.
4. A personality tone.

Select **Start using Foxora** to save the choices, or **Skip** to keep the existing voice defaults. You can change these later under **Settings → Voice**.

## Verify the workspace

![First-run setup in Foxora Desktop v5.0.3](/docs/images/v5.0.3/desktop/new-task.webp)

1. Confirm the **foxora** workspace opens under the expected account.
2. Choose **New Task** and check the autonomy pill below the composer.
3. Open the narrowest project folder required for file work, or stay project-free for questions and planning.
4. Send one small, reversible request.
5. Verify the result in the transcript, Stage, project, or external destination.

If the selected role or goals appear wrong, finish the flow and change the task configuration directly. If the autonomy default is too broad, change it from the composer before sending the first request.