Account and workspace

This guide covers everything around your account: signing in, choosing between workspaces, the first-run onboarding wizard, the language and theme controls, and signing out. If you are installing Chorus on your own machine for the first time, start with Get started — it covers the local email/password install, and this page does not repeat it.

Sign in

Enter your email or local username and select Continue. Chorus discovers the available sign-in methods before asking for a password:

• Local workspace account. Use the username or email from your invitation. Choose the workspace if prompted, then enter your password. Usernames and emails are case-insensitive.
• Single sign-on (SSO). Use your email and complete authentication with your workspace’s identity provider.
• Default Auth. The single account configured with DEFAULT_USER and DEFAULT_PASSWORD uses its email and deployment password. This is separate from managed local workspace accounts.
• Multiple identities. Choose the intended local workspace, SSO workspace, default account, or Super Admin identity. Configuring a default account does not bypass this choice.

A local workspace uses local accounts, not OIDC alongside them. The same email may still have separate identities in other workspaces. For deployment setup, see Super Admin and authentication setup.

Accept an invitation or reset a password

Open the link your administrator shares privately and set a password of at least 8 characters and at most 72 UTF-8 bytes. Links expire after 24 hours, work once, and are replaced when a new link is issued. Chorus does not email them automatically. Completing the form does not sign you in: return to sign-in and use your username or email and new password. Ask your Workspace Admin for a fresh invitation or reset link if needed; there is no public registration or self-service password reset.

Choose a workspace

If only several SSO workspaces match, the chooser lists their names and identity providers. If local accounts or other sign-in methods also match, use the identity picker instead. Verify the workspace before entering a password; matching usernames or emails in different workspaces do not represent one shared account. You can go back and change the identifier.

First-run onboarding

The first time you enter a fresh workspace, Chorus opens a six-step onboarding wizard. You can skip it and finish later. It walks you through:

1. Welcome — a look at the pipeline your work travels through: Idea → Proposal → Task → Execute → Verify → Done.
2. Create an agent — name an AI agent and choose its permissions; Chorus generates an API key for it. (Full agent setup lives in Prepare agent access — this is the quick inline version.)
3. Copy the API key — save it somewhere safe. It is shown only once.
4. Install — choose your agent client (Claude Code, Codex, Kiro, OpenCode, OpenClaw, or others) and follow the setup steps shown for it.
5. Test — Chorus waits until your agent connects, then confirms.
6. Done — a setup summary, with shortcuts to your projects and settings.

You can reopen the wizard any time from Settings.

What the agent does

The Create an agent and Test steps set up and then verify an AI agent identity. Once you create the agent and install its client, the agent connects to Chorus on its own; the Test step just watches for that connection.

For how each client platform connects and behaves, see the agent platforms reference.

The first-run onboarding wizard walks you through connecting your first agent; you can skip it and reopen it from Settings.

Display name and avatar

Open Settings to edit your own profile. These controls are for signed-in users, including local, OIDC, and Default Auth users, not agent API keys or the Super Admin panel.

• Display name: enter 1–32 Unicode code points after trimming surrounding whitespace. Emoji are supported; a composed emoji may count as more than one. Select Save or press Enter outside text composition. Cancel discards the draft. This changes your visible name, not your login username or email; a customized name is not overwritten by later OIDC sign-ins.
• Avatar: select Randomize to preview a generated avatar. Repeat until satisfied, then select Save. Cancel or leaving the page discards the unsaved preview. This is a generated avatar selector, not an image-upload field.

Typing or randomizing alone never saves. Wait for confirmation; a failed save keeps your previous saved profile and lets you retry. Name and avatar save independently. Saved changes update the current account display and persist after reload; they do not edit another workspace identity.

Preview an avatar or edit your display name, then save each change explicitly.

Language and theme

Your display preferences live in the sidebar footer.

• Theme — choose Light, Dark, or System (which follows your operating system).
• Language — choose English, 中文, 한국어, or 日本語, and the interface switches immediately. You can also change the language from the Settings page.

Sign out

The sidebar footer has a Sign out button. Selecting it ends your session and returns you to the sign-in screen, where you can sign in again with the same or a different email.

Next

With an account and an agent in place, read The AI-DLC workflow to see how work moves from idea to done, or jump straight to Capture an idea.