> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argentos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboarding

> Step-by-step guide to setting up your ArgentOS agent.

## The Setup Wizard

After installation, the setup wizard walks you through:

<Steps>
  <Step title="Authentication">
    Connect your Anthropic account.
  </Step>

  <Step title="Identity">
    Configure your agent's name and personality.
  </Step>

  <Step title="Channels">
    Connect messaging platforms.
  </Step>

  <Step title="Workspace">
    Set the agent's working directory.
  </Step>

  <Step title="Memory">
    Initialize the MemU memory database.
  </Step>
</Steps>

```bash theme={null}
argent onboard
```

## Restart Onboarding

If you need to re-run onboarding (broken install, changed config, fresh start), you can force it to show again.

### Quick Reset (Terminal)

```bash theme={null}
defaults delete ai.argent.mac onboardingSeen 2>/dev/null
defaults write ai.argent.mac onboardingVersion -int 0
open -a /Applications/Argent.app
```

<Info>
  This resets the two UserDefaults keys that Argent.app uses to decide whether to show onboarding, then relaunches the app. The onboarding wizard will appear on next launch.
</Info>

### How It Works

Argent.app determines onboarding state from UserDefaults — **not** by checking whether Postgres, Redis, or the gateway are installed. Two keys control it:

| Key                        | Type | Description                              |
| -------------------------- | ---- | ---------------------------------------- |
| `argent.onboardingVersion` | Int  | Version of onboarding the user completed |
| `argent.onboardingSeen`    | Bool | Whether onboarding was completed at all  |

Onboarding shows if the stored version is lower than the current required version, or if `onboardingSeen` is false.

### When to Restart

<Tip>
  Restarting onboarding does **not** delete your data, memory, tasks, or configuration. It only resets the onboarding completion flag so the wizard shows again.
</Tip>

* After a fresh install that failed partway through
* After changing your Anthropic auth or switching accounts
* After a major version upgrade that changes onboarding steps
* If the gateway was reconfigured and the app needs to reconnect

## Agent Identity

Your agent's identity is defined in the `IDENTITY` template at `~/.argentos/agents/main/agent/IDENTITY.md`. This shapes how the agent communicates across all channels.

## Workspace

The agent workspace (default: `~/argent/`) is where your agent stores files, runs code, and manages its working state. This includes:

* `DASHBOARD.md` — Instructions for the dashboard protocol
* Downloaded files and generated content
* Task artifacts and reports