Skip to content
Gormes Docs

Switch profiles for client work

Switch profiles for client work

Section titled “Switch profiles for client work”

Outcome: Two or more isolated Gormes profiles, each with its own config, secrets, sessions, and memory store, switchable in one command.

Prerequisites: gormes installed.

Steps

Section titled “Steps”

  1. List existing profiles

    Terminal window
    gormes profile list

    * marks the active profile.

  2. Create a new profile

    Terminal window
    gormes profile create client-acme

    This builds a fresh ~/.gormes lookalike directory for the profile. Add --clone-all to copy the default profile’s non-runtime files into it.

  3. Switch to the profile

    Terminal window
    gormes profile use client-acme

    profile set is an accepted alias for profile use.

  4. Configure provider, model, and channels inside the profile

    Terminal window
    gormes auth add openai --api-key sk-...
    gormes setup model
    gormes config show

    Every command run while this profile is active reads and writes the profile’s home only.

  5. Open chat under a specific profile without switching

    Terminal window
    gormes --profile client-acme chat

Verify

Section titled “Verify”
Terminal window
gormes profile show

Expected output:

active profile: client-acme
root: .../.gormes/profiles/client-acme

Troubleshooting

Section titled “Troubleshooting”
  • profile not found → Re-run gormes profile list to confirm the exact name, or create it with gormes profile create <name>.
  • Wrong profile picked up by a script → Set the profile per-invocation with --profile <name> rather than relying on the persisted active profile.

See also

Section titled “See also”