Skip to main content

​
The Setup Wizard

After installation, the setup wizard walks you through:
1

Authentication

Connect your Anthropic account.
2

Identity

Configure your agent’s name and personality.
3

Channels

Connect messaging platforms.
4

Workspace

Set the agent’s working directory.
5

Memory

Initialize the MemU memory database.
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)

defaults delete ai.argent.mac onboardingSeen 2>/dev/null
defaults write ai.argent.mac onboardingVersion -int 0
open -a /Applications/Argent.app
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.

​
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:
KeyTypeDescription
argent.onboardingVersionIntVersion of onboarding the user completed
argent.onboardingSeenBoolWhether 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

Restarting onboarding does not delete your data, memory, tasks, or configuration. It only resets the onboarding completion flag so the wizard shows again.
  • 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