omo-switch

omo-switch is a cross-platform desktop app for switching Oh My OpenAgent model groups. It maintains named category mappings, Oh My OpenAgent agent overrides, and optional OpenCode agent model overrides, then syncs the selected group into the matching config files.

The active application is built with Tauri 2. The Svelte 5 and TypeScript frontend provides the quick-switch and settings interfaces, while the Rust backend owns config persistence, projection, backups, tray integration, and native Windows/macOS behavior.

Features

• Model groups with category and agent mappings.
• Quick switching from the system tray or menu bar.
• Conditional OpenCode agent model overrides.
• Native Windows NSIS and macOS app/DMG packages.

Requirements

• Node.js 22.23.0 and npm.
• Rust 1.77.2 or later with Cargo. CI and release workflows build with Rust 1.96.0.
• Platform prerequisites required by Tauri 2 for Windows or macOS desktop builds.
• Oh My OpenAgent config location: ~/.config/opencode/oh-my-openagent.json.
• Optional OpenCode config location: ~/.config/opencode/opencode.json.

Download

Tagged release workflows produce these Tauri artifacts:

• GitHub Release asset: omo-switch_0.1.0_x64-setup.exe (Windows NSIS installer).
• GitHub Release asset: omo-switch_0.1.0_aarch64.dmg (macOS disk image).
• GitHub Release asset: omo-switch_0.1.0_aarch64.app.tar.gz (macOS app bundle archive preserving bundle metadata and executable permissions).

https://github.com/seho-dev/omo-switch/releases/latest

Unsigned macOS builds

Current macOS release artifacts are unsigned and not notarized. macOS may block the app or require approval in System Settings > Privacy & Security. After moving omo-switch.app into /Applications, the quarantine attribute can be removed manually:

sudo xattr -dr com.apple.quarantine /Applications/omo-switch.app

No signing or notarization is performed by the current release workflow.

Configuration behavior

omo-switch stores its own groups and selection state in one config file, separately from target application configs.

File	Purpose
~/.config/omo-switch/config.json	omo-switch group definitions, selection, and write metadata.
~/.config/opencode/oh-my-openagent.json	Rewritten when switching groups or saving the active group.
~/.config/opencode/opencode.json	Patched only when effective OpenCode agent model overrides exist.

Before rewriting target configs, omo-switch creates backups under its config directory. Only config.json is read or written for omo-switch data; legacy split files are ignored and are not migrated.

When switching groups, omo-switch rewrites the Oh My OpenAgent projection. Saving the active group reapplies that projection immediately. OpenCode sync is skipped when no effective OpenCode overrides exist, so a missing opencode.json only blocks operations that actually require OpenCode changes.

For OpenCode, omo-switch patches only agent.<name>.model. Existing fields inside agent objects and unrelated top-level keys such as $schema, plugin, and provider are preserved.

Development

Install dependencies:

npm ci

Run the frontend and contract tests:

npm test

Run the six native delivery contract tests from PowerShell:

$env:OMO_CHARACTERIZE_NATIVE_GAPS='1'; npm test -- --run src/native-gaps.test.ts

Run the same six tests from a POSIX shell:

OMO_CHARACTERIZE_NATIVE_GAPS=1 npm test -- --run src/native-gaps.test.ts

Run the Tauri app in development:

npm run tauri dev

Build the frontend and Rust backend independently:

npm run build
cargo test --manifest-path src-tauri/Cargo.toml
cargo fmt --manifest-path src-tauri/Cargo.toml --all -- --check

Build native Tauri packages for the current platform:

npm run tauri build

The configured package identity is dev.seho.omo-switch, product name omo-switch, version 0.1.0. Tauri targets are Windows NSIS plus macOS app and DMG.

Release process

Pushing a v* tag starts the release workflow. Each build job first requires the pushed tag to exactly equal v<version> from src-tauri/tauri.conf.json, then uses the pinned Node and Rust versions above to build and assert the exact Tauri artifact paths. The macOS job packages omo-switch.app as omo-switch_0.1.0_aarch64.app.tar.gz with macOS tar so bundle metadata and executable permissions survive transfer. A least-privilege publishing job downloads each platform artifact into an explicit directory and creates or updates the GitHub Release with the exact NSIS installer, app archive, and DMG.

License

No license has been declared yet.