Aweswitch

aweswitch: Agent Profile Switcher
  A tiny local launcher for switching AI agent runtime profiles.
One config, one command — works the same on Ubuntu, macOS, and Windows.
  Start different agent sessions with different API endpoints, tokens, and models without rewriting global agent config.

    English ·
    简体中文 ·
    Webioinfo
Run different agent profiles side by side without breaking sessions that are already open.

aweswitch reads profiles from ~/.config/aweswitch/config.json and offers two modes:

- Launch mode (aweswitch ) — starts a new agent session with isolated env. Each session gets its own API endpoint, token, and model. Different terminals can run different profiles simultaneously. Env is frozen at launch time.
- Write mode (aweswitch apply ) — makes a profile the agent's persistent default: Claude env into ~/.claude/settings.json, Codex provider+model into ~/.codex/config.toml, OpenCode provider+models into ~/.config/opencode/opencode.json, and zcode providers+models into ~/.zcode/v2/config.json. A bare aweswitch apply bulk-syncs every OpenCode and zcode profile; --opencode / --zcode narrow the bulk to one agent. Claude and Codex keep one active default at a time.

It is intentionally small. Today it supports Claude Code, Codex, OpenCode, and zcode profiles, plus official-login accounts (Claude Code / Codex OAuth).

Quick Start

aweswitch follows the same loop as the rest of the awesome family: hand the bootstrap to an agent once and you land with a working first profile, then manage day-to-day work in natural language. Step 1 covers that bootstrap and gets you using aweswitch right away; steps 2 and 3 are the more advanced operations — equipping the management skill and the daily scenarios in detail. One rule is specific to this tool — the agent never…