Account profiles

Each account gets its own named profile. You sign in to it once, use it, and sign out of it on its own. Deffier never switches accounts for you and never rotates between them when one hits a limit.

In the app

Open the agent menu (the ⌄ next to + in the tab bar). It has an Accounts section:

  • Pick an account to open a tab signed in as that profile. The CLI starts by itself, and the tab is named after the profile, for example claude2 3.
  • + Claude / Codex / Gemini creates the next free profile (claude3, …). Sign in once in that tab.
  • A tab keeps its account, also after a restart. Anything you type in it uses that profile, for example claude --resume.

Supported CLIs

CLI Profiles How the login stays separate
Claude Code claude1 … Own config folder: CLAUDE_CONFIG_DIR
Codex codex1 … Own config folder: CODEX_HOME
Gemini CLI gemini1 … Own home: GEMINI_CLI_HOME, plus GEMINI_FORCE_FILE_STORAGE=true (see below)
Antigravity agy1 … Your agy-profile script (~/.gemini/profiles); Deffier lists and starts them
Hermes hermes · <name> Hermes's own profiles (hermes -p <name>); Deffier lists and starts them
  • Where profiles live: Claude, Codex and Gemini profiles are under ~/.swarmherd/profiles/<cli>/<n>/.
  • Why Gemini needs the extra setting: without GEMINI_FORCE_FILE_STORAGE, Gemini keeps its login in one Windows Credential Manager entry (gemini-cli-oauth) shared by every profile.
  • Shared with your normal config folder (linked, so new skills show up everywhere):
    • Claude: skills, agents, commands, plugins, hooks, scripts.
    • Codex: skills, plugins.
    • Gemini: extensions, skills.
  • Copied once (--refresh copies again):
    • Claude: CLAUDE.md, settings.json.
    • Codex: config.toml, AGENTS.md.
    • Gemini: settings.json, GEMINI.md, trustedFolders.json.
  • Never shared: the login. Plain claude, codex and gemini keep using your default accounts.

From a terminal

claude2 · codex1 · gemini3     # in a Deffier terminal; the first run creates the profile
deffier profile list            # every profile: signed in or not, email (also agy and Hermes)
deffier profile logout codex 1  # signs out codex1 only
deffier profile init claude 2 --refresh
  • Outside Deffier: to use the launchers in other terminals, add <Deffier>/cli to your PATH.
  • Adding or changing a CLI: edit cli/agent_profiles.json, then run python cli/gen_launchers.py.

Rules

  • Deffier never reads, copies or uploads a login. list only reports whether a login file exists, plus the account email the CLI itself saved.
  • Use only accounts you own and pay for. Each provider's terms apply to each account.
  • Deffier leaves out automatic account rotation on purpose.

This guide is doc/PROFILES.md in the Deffier repo.