CLI Model Switcher v0.4.0

CLI Model Switcher v0.4.0

Quick Install

Linux, macOS, or WSL:

curl -fsSL https://raw.githubusercontent.com/YuxuanSun123/cli-model-switcher/v0.4.0/install.sh | sh -s -- --branch v0.4.0

Windows PowerShell:

$installer = Join-Path $env:TEMP "cli-model-switcher-install.ps1"
irm https://raw.githubusercontent.com/YuxuanSun123/cli-model-switcher/v0.4.0/install.ps1 -OutFile $installer
powershell -ExecutionPolicy Bypass -File $installer -Branch v0.4.0

Changes

Added

• lite / ai-lite, a simplified one-command project agent bridge setup that auto-recommends targets and falls back to Codex, Claude, and OpenCode.
• ai-lite --fix, --prompt, --undo, and --all-common, plus setup --lite and installer --lite for minimal installs.
• Lite smoke coverage in CI and release validation, plus a README shortest path for minimal setup.
• German, Japanese, French, and Italian README pages, plus expanded language navigation.
• about command and ayatori / ayatori-nexus shell entrypoints for the Ayatori Nexus project codename.
• agent recommend for project-aware bridge install suggestions, plus platform support levels in agent platforms.
• Agent platform adapters for Amp, Devin, Junie, Zed, Kilo, GitLab Duo, Firebase Studio, Android Studio Gemini, OpenHands, Warp, and Trae.
• agent platforms command plus an OpenClaw platform adapter for ~/.openclaw/workspace with AGENTS.md and TOOLS.md bridge files.
• agent targets and agent detect commands, plus Continue, Goose, and Kiro agent bridge targets.
• agent install --detected to install only bridge targets discovered in the current project.

CLI Model Switcher v0.3.0

CLI Model Switcher v0.3.0

Quick Install

Linux, macOS, or WSL:

curl -fsSL https://raw.githubusercontent.com/YuxuanSun123/cli-model-switcher/v0.3.0/install.sh | sh -s -- --branch v0.3.0

Windows PowerShell:

$installer = Join-Path $env:TEMP "cli-model-switcher-install.ps1"
irm https://raw.githubusercontent.com/YuxuanSun123/cli-model-switcher/v0.3.0/install.ps1 -OutFile $installer
powershell -ExecutionPolicy Bypass -File $installer -Branch v0.3.0

Changes

Added

• workspace command and ai-workspace shell helper for opening several agents in one terminal workspace and switching between them with tmux or Windows Terminal tabs.
• workspace up, workspace targets, workspace add, workspace next, and workspace prev to reduce repeated typing in same-terminal multi-agent workflows.
• Project-local workspace targets, detailed workspace show/status, interactive workspace choose, and short shell helpers ai-ws, ai-wup, ai-wgo, and ai-wpick.
• agent command and ai-agent helper for installing Codex/Claude/OpenCode instruction bridges, so agent-side requests like /switch claude can run ai-workspace switch claude.
• Additional agent bridge targets for Gemini, Qwen Code, GitHub Copilot/VS Code, Cursor, Windsurf/Cascade, Aider, Cline, Roo Code, generic AGENTS.md, and custom --file rule paths.
• install-bin for POSIX executable shims on Linux, macOS, and WSL, plus default shim installation and interactive PATH setup from install-unix for agent-side and non-interactive shell compatibility.
• GitHub Actions CI for Windows, Linux, and macOS validation.
• One-command installers: install.sh for Linux/macOS/WSL and install.ps1 for Windows PowerShell.

Fixed

• macOS path and URL opening now prefers the native open command before Linux xdg-open.
• Session launch commands now refresh the combined memory context using the requested --cwd, so project memory is included when starting an agent from another directory.
• Session and workspace profile resolution now respects the requested --cwd when project-local profiles or aliases are present.
• Explicit profile names now take precedence over recipe aliases, so a profile named opencode is not shadowed by an opencode recipe alias.
• Empty project-local workspace targets now override global targets, allowing project resets to fall back to suggestions.
• PowerShell wrapper generation now includes the previously missing ai-page helper.
• PowerShell ai-current, ai-status, ai-paths, and ai-list helpers now forward optional arguments such as --json.
• ai-run now uses the same profile environment builder as shell/session launch commands and includes AI_CLI_API_PROVIDER and AI_CLI_API_KIND.
• Session lookup now resolves profile aliases, recipe aliases, and strategy names when switching, attaching, or stopping sessions.

v0.2.0 - AI session handoff workflow

Highlights

• Add managed AI CLI sessions with ai-session.
• Add shared-memory handoffs with ai-handoff.
• Support session backends for tmux, Windows Terminal, PowerShell windows, and printable fallback commands.
• Add shell wrappers for PowerShell, cmd.exe, Bash/Zsh, and fish.
• Update English, Simplified Chinese, and Traditional Chinese documentation.

Example

PowerShell:

ai-session start claude --backend wt
ai-session start opencode-openrouter --backend print --arg=--debug
ai-session list
ai-handoff claude "Review the current Codex work and look for regressions."

Validation

• Python py_compile passed.
• Skill quick_validate passed.
• Secret audit passed with no obvious findings.
• Session smoke test passed with print backend, handoff memory write, and session cleanup.

See CHANGELOG.md for the full list.

v0.1.0 - Initial release

Highlights

• Initial CLI Model Switcher skill and standalone helper script.
• Profile switching for Codex, Claude Code, OpenCode, Gemini CLI, local models, and OpenAI-compatible gateways.
• Setup wizard and one-step recipes for common provider/model stacks.
• Shared memory across CLI agents through AI_CLI_MEMORY.
• API presets, task strategies, shell helpers, doctor repair, secret audit, and portable export/import.
• English README plus Simplified Chinese and Traditional Chinese documentation pages.

Validation

• Python py_compile passed.
• Skill quick_validate passed.
• Secret audit passed with no obvious findings.

See CHANGELOG.md for the full list.