AgentSwitch

Native desktop GUI for managing AI coding-agent configuration across providers. Toggle skills, hooks, rules, and MCP servers — browse, diff, and manage chat histories — without hand-editing provider files.

Features

• Item Toggle — per-item enable/disable with collision-aware moves and provider-specific JSON/TOML mutation.
• Bulk Toggle — Enable All / Disable All for filtered item categories with exact file/path rollback on failure.
• Scope Switching — project-level vs global configuration, with workspace browser.
• Diff Workbench — compare project and global configs with stable, secret-safe fingerprints. Detects duplicates, missing targets, and scope conflicts.
• Hook Cockpit — static hook inventory showing event, matcher, handler, blocking risk, timeout, duplicates, and project/global overlaps.
• Chat Manager — unified chat history browser across Claude Code, Codex CLI, Kiro, and OpenCode. Per-provider filtering when a provider is selected, or browse all providers together. Search, export (single JSON or multi-chat ZIP), soft-delete with Trash, and import archived sessions.
• Inline Editor — edit instruction files, rules, and steering docs without leaving the app.
• Atomic Config Writes — structured mutations use same-directory atomic replacement, stale-edit detection, and compatible .bak files.
• Cross-platform — Windows, Linux, and macOS builds.

Antigravity (agy) is the supported Google CLI. The discontinued Gemini CLI is not treated as a separate provider. Antigravity may still use the documented GEMINI.md filename.

Supported Providers

Provider	Instruction File	Skills	Hooks	MCP	Native Chats
Claude Code	CLAUDE.md	.claude/skills/	.claude/settings*.json	Project .mcp.json; approval lists in settings	Best-effort JSONL (internal format)
Codex CLI	AGENTS.md	.codex/skills/, .agents/skills/	config.toml, hooks.json	config.toml mcp_servers	Best-effort JSONL (internal format)
Antigravity CLI (agy)	GEMINI.md, AGENTS.md	.agents/skills/, global skills/	.agents/hooks.json	.agents/mcp_config.json	Not supported (encrypted/internal)
Kiro	Steering documents	Steering, Specs, Agents	Agent JSON	settings/mcp.json	JSON + JSONL ACP sessions
OpenCode	AGENTS.md	.opencode/skills/ plus .agents//.claude/ compatibility	Plugins	opencode.json	Best-effort SQLite with schema detection

Install

Download the matching binary from Releases:

Platform	Asset
Windows x86-64	agent-switch-windows-x86_64.exe
Linux x86-64	agent-switch-linux-x86_64
macOS Intel	agent-switch-macos-x86_64
macOS Apple Silicon	agent-switch-macos-aarch64

Build from Source

Requires the Rust toolchain (1.75+). SQLite is bundled via rusqlite — no system dependency needed.

git clone https://github.com/RoyCoding8/AgentSwitch.git
cd AgentSwitch
cargo build --release

Output binary:

• Windows: target/release/agent-switch.exe
• Linux / macOS: target/release/agent-switch

Linux Dependencies

sudo apt-get update
sudo apt-get install -y \
  pkg-config libgtk-3-dev libx11-dev libxi-dev \
  libxkbcommon-dev libwayland-dev libgl1-mesa-dev libasound2-dev

Usage

Launch AgentSwitch from the workspace you want to inspect, or use Browse to pick a workspace at runtime.

Tab	Purpose
Items	Toggle discovered provider config items (skills, hooks, rules, MCP servers).
Hooks	Inspect hook execution order, scope, matcher, handler type, blocking risk, duplicates, and project/global overlaps.
Diff	Compare project vs global config with stable, secret-redacted fingerprints.
Chats	Browse, search, export, import, and trash chat sessions across all providers.

Diff Workbench and Hook Cockpit are read-only diagnostics. Toggle actions remain in Items.

Architecture

src/
  main.rs          eframe entry point
  app.rs           state machine and UI orchestration
  batch.rs         exact multi-item recovery and rollback
  config_store.rs  atomic writes, backups, and verified moves
  provider.rs      current provider paths, CLI names, and instructions
  types.rs         shared item, provider, and scope types
  scanner.rs       provider filesystem discovery
  toggler.rs       rename and provider-specific structured mutations
  diagnostics.rs   project/global diff workbench engine
  hook_diag.rs     static hook cockpit engine
  chat.rs          chat history scanner, archive, export/import, trash, OpenCode SQLite
  editor.rs        inline markdown editor state
  ui/
    mod.rs         module declarations
    theme.rs       dark theme colors, fonts, and style
    sidebar.rs     provider list and scope tabs
    item_list.rs   toggle list with filter tabs
    diff_panel.rs  diff workbench UI
    hooks_panel.rs hook cockpit UI
    chat_panel.rs  chat manager UI
    editor_panel.rs inline editor UI
    status_bar.rs  bottom status summary

License

Apache 2.0. See LICENSE.