Releases: skh2945932142/omp-switch
Release list
OMP Switch v0.6.0
OMP Switch v0.6.0
Linux support lands. The desktop app, a new terminal UI, and the credential vault now run on Linux alongside Windows — plus the maintenance automation that keeps the project honest (schema watch, install regression, submission tooling). Windows behavior is unchanged: every platform difference is keyed on process.platform and the DPAPI path is byte-identical.
Downloads
| Artifact | Platform | Notes |
|---|---|---|
| OMP-Switch-Setup-0.6.0.exe | Windows x64 | NSIS installer, per-user |
| OMP-Switch-0.6.0-win.zip | Windows x64 | Portable build |
| OMP-Switch-0.6.0-linux.AppImage | Linux x64 | Portable AppImage |
| OMP-Switch-0.6.0-linux.deb | Linux x64 (amd64) | Debian/Ubuntu package, /opt/OMP Switch |
| SHA256SUMS.txt | - | SHA256 verification for all four artifacts |
Linux desktop app
- No .NET/MSVC needed on Linux —
build:nativeis platform-keyed (scripts/build-native.mjs);pnpm devandpnpm buildjust work. - Linux console shim (
bin/omp-switch-cli+scripts/after-pack.mjs) replacesnative/cli-proxy;omp-switch-cli --json …works from a terminal. - Interactive OAuth login opens a terminal emulator (
$OMP_SWITCH_TERMINAL, xdg-terminal-exec, gnome-terminal, konsole, xfce4-terminal, xterm, alacritty, kitty, foot) instead of erroring. - Window chrome: solid surfaces on Linux (Mica stays Windows-only); the topbar no longer reserves Windows overlay-button space.
- CI:
verify-linux(typecheck/test/build + headless--jsonsmoke) andlinux-package(main-branch AppImage/deb + shim smoke) join the Windows verify job; releases attest Linux artifacts and merge SHA256SUMS across platforms.
Linux credential vault
- libsecret primary: each API key is a direct keyring entry (service
omp-switch, attributecredential=<id>), resolved for OMP bysecret-tool lookup …— no bridge binary, millisecond cold start against OMP's 10s budget. Command grammar frozen against real OMP 18.x on Linux. - age fallback when no Secret Service answers: X25519 keyfile identity (0600) + per-credential ciphertexts (0700), resolved by
age -d. Honestly weaker (identity sits beside the ciphertext — protects against casual copy, not a user-level attacker); only engages headless,OMP_SWITCH_SECRET_BACKENDforces a backend for testing. - Orphan/reference tracking extended to the Linux command forms (
collectReferencedCredentialIds);secret:deletestill refuses while a config references the credential. - Windows vault (
secrets.v1.json+ C# bridge) untouched.
Terminal UI (omp-switch-tui)
- New Ink/React workspace package: providers, roles (resolution chain + cycle detection), snapshots, diagnostics, and the two-step save (line diff → confirm) over
previewPatch/commitPatch— the same contracts the GUI uses. - Non-interactive
--help/list/validatesubcommands (pure JSON, TTY-guarded otherwise) for scripts and CI. pnpm build:tui→ single-filepackages/tui/dist/main.js.
Refactoring under the hood
@omp-switch/coreand@omp-switch/sharedare real pnpm workspace packages now (the path alias was declared in five configs); the shared package holds the pure diff/form/role/selection logic previously locked in renderer.tsxfiles.- Fixed: provider-scope path matching was Windows-only (backslash normalization); it now takes the platform separator, so scoped
disabledProvidersrules behave on POSIX. - The mock API's save delegates to the adapter's own
applyConfigPatch— demo and real saves can no longer drift.
Maintenance automation
- OMP schema watch (weekly): opens an issue when upstream OMP ships a major we cannot write; manual checklist in
docs/omp-schema-tracking.md. pnpm render:packagingis a cross-platform node script now;publish-winget.mjs/publish-choco.mjsstage submissions (pushes stay human-gated).- Windows install regression (nightly + tags): install previous release → silent upgrade → exercise the installed CLI → assert a clean silent uninstall.
Known limitations
- The Linux AppImage icon is an upscaled 256px placeholder — a proper 512px+ render is wanted.
- Real-keyring end-to-end verification (
libsecret-tools,ageinstalled) is pending on a desktop machine; unit and contract tests cover the command grammar. - winget/Chocolatey submissions remain pending upstream review (manifests render for 0.6.0 once released).
OMP Switch v0.5.6
OMP Switch v0.5.6
This patch release hardens session and gateway behavior while making the desktop workspace clearer, more accessible, and more resilient in compact windows.
Downloads
| Artifact | Platform | Notes |
|---|---|---|
| OMP-Switch-Setup-0.5.6.exe | Windows x64 | NSIS installer, per-user |
| OMP-Switch-0.5.6-win.zip | Windows x64 | Portable build |
| SHA256SUMS.txt | - | SHA256 verification for both artifacts |
The installer and portable build include the Windows DPAPI-backed secret bridge and the packaged omp-switch-cli.exe.
Changed
- Accessible, quiet desktop controls:
- Unified icon-only actions behind a reusable
IconButton, so each action has both a tooltip and an accessible name. - Added named save, conflict, confirmation, and shortcut dialogs.
- Added a focus-managed inspector drawer with initial focus, Escape dismissal, and trigger-focus restoration.
- Unified icon-only actions behind a reusable
- Focused motion and responsive behavior:
- Replaced broad transitions, overshooting navigation motion, global child staggering, and workspace scaling with short property-level transitions.
- Honors
prefers-reduced-motionfor Motion-driven drawer and navigation changes. - Uses a 56px vertical icon rail at 760px-wide desktop windows; the Electron minimum width is now 760px.
- Clearer operational pages:
- Gateway starts with one full-width empty state and one primary creation action.
- Usage now separates date filtering from export and reindexing.
- Model cards use one current-state signal rather than duplicate preferred-state badges.
Fixed
- Provider editor fields now belong to a semantic form, support Enter to save, and provide stable names for browser tooling.
- Interactive controls use a dedicated visible border token while quiet dividers remain subtle.
- Session empty details use less vertical space in compact windows.
Security
- Sanitized FTS snippets before rendering, isolated gateway health probes to the selected profile, and hardened session-index metadata handling.
Known Limitations
- Gateway remains a local Windows feature and requires a configured pool before it can route requests.
- OAuth integration continues to depend on each provider's external authentication flow.
- Session indexing is local-only and reflects files available beneath the active profile's agent directory.
- Update checking requires the release workflow's
OMP_UPDATE_ED25519secret to upload a signed manifest.
Verify what you downloaded
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-Setup-0.5.6.exe").Hash.ToLower()
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-0.5.6-win.zip").Hash.ToLower()
# Compare both values with SHA256SUMS.txt.
gh attestation verify ".\OMP-Switch-Setup-0.5.6.exe" --repo skh2945932142/omp-switchv0.5.5
OMP Switch v0.5.5
This release delivers comprehensive frontend architecture modularization, persistent gateway health probe monitoring with real-time latency indicators, SQLite FTS5 session full-text search, and multi-format session export (interactive offline HTML reports, Markdown, and raw JSON).
Downloads
| Artifact | Platform | Notes |
|---|---|---|
| OMP-Switch-Setup-0.5.5.exe | Windows x64 | NSIS installer, per-user |
| OMP-Switch-0.5.5-win.zip | Windows x64 | Portable build |
| SHA256SUMS.txt | - | SHA256 verification for both artifacts |
The installer and portable build include the Windows DPAPI-backed secret bridge and the packaged omp-switch-cli.exe.
Highlights
Added
- Persistent Gateway Health Probes & LED Status Badges:
- Automatically records upstream latency, HTTP status codes, and failure counts into SQLite with rolling history retention (up to 50 entries per upstream).
- Runtime request observations and failovers automatically update upstream health.
- Inline LED status capsules (🟢
healthy, 🟡degraded, 🔴unhealthy, ⚪untested) with hover tooltip timelines. - "Probe All" toolbar action for one-click health auditing across all configured upstreams.
- SQLite FTS5 Full-Text Session Search:
- Fast inverted-index full-text search across all conversation turns and assistant messages using SQLite FTS5 (
unicode61tokenizer). - Highlighted
<mark>snippet previews directly in the session list.
- Fast inverted-index full-text search across all conversation turns and assistant messages using SQLite FTS5 (
- Multi-Format Session Export:
- Export standalone offline HTML reports (
.html) featuring embedded dark/light themes, monospace code blocks, and collapsible<think>thinking chain blocks (ready forCtrl+PPDF printing). - Export standard Markdown (
.md) and raw JSON (.json) datasets.
- Export standalone offline HTML reports (
Refactored
- Frontend Submodule Architecture:
- Decoupled the 1000+ line monolithic
workbench-modules.tsxinto modular domain submodules:modules/surfaces/,modules/gateway/,modules/project/, andmodules/sessions/. - Maintained complete backward compatibility via clean aggregator exports.
- Decoupled the 1000+ line monolithic
Checksums
28be251910c98978bdefe8fcbb112afeb852b27f6d23bcfb9502ac9b72c79fe9 OMP-Switch-Setup-0.5.5.exe
e8438273aa7c4c759d465b835b1db94f0e51b9dda929e36219907effe446049a OMP-Switch-0.5.5-win.zip
Verify what you downloaded
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-Setup-0.5.5.exe").Hash.ToLower()
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-0.5.5-win.zip").Hash.ToLower()
# Compare both values with SHA256SUMS.txt.
gh attestation verify ".\OMP-Switch-Setup-0.5.5.exe" --repo skh2945932142/omp-switchOMP Switch v0.5.4
OMP Switch v0.5.4
This release adds gateway failover tooling, richer session and usage exports, and a set of
headless CLI and provider-editor improvements.
Downloads
| Artifact | Platform | Notes |
|---|---|---|
| OMP-Switch-Setup-0.5.4.exe | Windows x64 | NSIS installer, per-user |
| OMP-Switch-0.5.4-win.zip | Windows x64 | Portable build |
| SHA256SUMS.txt | - | SHA256 verification for both artifacts |
The installer and portable build include the Windows DPAPI-backed secret bridge and the packaged
omp-switch-cli.exe.
Highlights
Added
- Gateway failover tooling: benchmark an upstream with a one-token probe, propagate downstream
disconnects to upstream requests, reorder upstream priority, and harden streaming cleanup. - Session history tools: filter sessions by title, model, provider, or ID and export a structured
Markdown report with usage and cost summaries. - Usage export: export the current profile's complete usage report as standard JSON, including
model/provider totals and daily trends. - Headless CLI workflows: preview patches with plan --profile --patch without
writing to disk, and inspect snapshot history with snapshots --profile . - Provider and model editing: clone models, copy canonical model selectors, and discover the
expanded set of OMP API options from the editor.
Fixed
- Added strict validation for model field types at the core boundary so malformed provider data is
reported before it can be written. - Preserved full model identifiers and display names in the provider editor and workspace cards.
Checksums
885bfd510855ad00806bac6173aad9411e64c8111809e7be9d3a835f9e25ddb5 OMP-Switch-Setup-0.5.4.exe
2d2c026022c933030e747e06ea8e9f6e83e5dac8bfab7c64f57d61a10ed0d094 OMP-Switch-0.5.4-win.zip
Verify what you downloaded
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-Setup-0.5.4.exe").Hash.ToLower()
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-0.5.4-win.zip").Hash.ToLower()
# Compare both values with SHA256SUMS.txt.
gh attestation verify ".\OMP-Switch-Setup-0.5.4.exe" --repo skh2945932142/omp-switchOMP Switch v0.5.3
OMP Switch v0.5.3
This release resolves model name and ID truncation across the Provider Editor Drawer and main workspace cards.
Downloads
| Artifact | Platform | Notes |
|---|---|---|
OMP-Switch-Setup-0.5.3.exe |
Windows x64 | NSIS installer, per-user |
OMP-Switch-0.5.3-win.zip |
Windows x64 | Portable build |
SHA256SUMS.txt |
— | SHA256 verification for both artifacts |
latest.json + latest.json.sig |
— | Signed update manifest (Ed25519) |
The installer and portable build include the Windows DPAPI-backed secret bridge and the packaged
omp-switch-cli.exe. The headless CLI image is published as
ghcr.io/skh2945932142/omp-switch-cli:0.5.3 and :latest.
Highlights
Fixed
- Model Name & ID Full Display Layout:
- Restructured the Provider Editor Drawer (
.model-editor-card) into a spacious two-tier layout, allocating 100% of row width toModel IDandDisplay Nameinputs to prevent long identifier truncation. - Added full
titlehover tooltips across model names and IDs in both the main Provider workspace card lists and the drawer view-mode mini-model list. - Added word-wrapping (
word-break: break-word/word-break: break-all) to handle multi-segment path names gracefully.
- Restructured the Provider Editor Drawer (
Verify what you downloaded
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-Setup-0.5.3.exe").Hash.ToLower()
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-0.5.3-win.zip").Hash.ToLower()
# Compare both values with SHA256SUMS.txt.
gh attestation verify ".\OMP-Switch-Setup-0.5.3.exe" --repo skh2945932142/omp-switchOMP Switch v0.5.2
OMP Switch v0.5.2
This release adds Model Provider deletion with cascading protection and delivers a major frontend architecture refactoring.
Downloads
| Artifact | Platform | Notes |
|---|---|---|
OMP-Switch-Setup-0.5.2.exe |
Windows x64 | NSIS installer, per-user |
OMP-Switch-0.5.2-win.zip |
Windows x64 | Portable build |
SHA256SUMS.txt |
— | SHA256 verification for both artifacts |
latest.json + latest.json.sig |
— | Signed update manifest (Ed25519) |
The installer and portable build include the Windows DPAPI-backed secret bridge and the packaged
omp-switch-cli.exe. The headless CLI image is published as
ghcr.io/skh2945932142/omp-switch-cli:0.5.2 and :latest.
Highlights
Added
- Provider Deletion with Cascading Protection:
- Dual operation entry points: Quick delete button on Provider cards (
.provider-delete) and dangerous action button in the drawer edit mode. - Multi-hop role reference chain inspection before deletion to warn about affected role bindings (e.g.,
@default,@smol). - Automatic cascading cleanup from
modelProviderOrderinconfig.yml. - Full two-step YAML Diff preview and automated snapshot backup before write.
- Dual operation entry points: Quick delete button on Provider cards (
Refactored
- Frontend Architecture Decoupling:
- Extracted 1650-line
App.tsxinto modular domain components:ModelsModule,ProviderDrawer,SettingsDrawer,DiagnosticsDrawer,TopBar, andLeftRail. - Encapsulated business state and Patch transactions into custom hooks (
useOmpConfig,useProviderForm). - Added Vitest test suite
models-module.test.tswith 100% test pass rate across 23 test suites (200 tests).
- Extracted 1650-line
Verify what you downloaded
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-Setup-0.5.2.exe").Hash.ToLower()
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-0.5.2-win.zip").Hash.ToLower()
# Compare both values with SHA256SUMS.txt.
gh attestation verify ".\OMP-Switch-Setup-0.5.2.exe" --repo skh2945932142/omp-switchOMP Switch v0.5.1
OMP Switch v0.5.1
This release fixes schema version classification for Oh My Pi (OMP) v18.x installations.
Downloads
| Artifact | Platform | Notes |
|---|---|---|
OMP-Switch-Setup-0.5.1.exe |
Windows x64 | NSIS installer, per-user |
OMP-Switch-0.5.1-win.zip |
Windows x64 | Portable build |
SHA256SUMS.txt |
— | SHA256 verification for both artifacts |
latest.json + latest.json.sig |
— | Signed update manifest (Ed25519) |
The installer and portable build include the Windows DPAPI-backed secret bridge and the packaged
omp-switch-cli.exe. The headless CLI image is published as
ghcr.io/skh2945932142/omp-switch-cli:0.5.1 and :latest.
Fixed
- OMP v18.x Compatibility: Added schema major
18toWRITABLE_OMP_SCHEMA_MAJORSso that installations reportingomp/18.0.3(and any 18.x) are correctly recognized as supported and fully writable rather than triggering a read-only mode warning.
Verify what you downloaded
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-Setup-0.5.1.exe").Hash.ToLower()
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-0.5.1-win.zip").Hash.ToLower()
# Compare both values with SHA256SUMS.txt.
gh attestation verify ".\OMP-Switch-Setup-0.5.1.exe" --repo skh2945932142/omp-switchOMP Switch v0.5.0
OMP Switch v0.5.0
This release delivers a comprehensive Apple × OpenAI hybrid UI/UX overhaul and fluid micro-haptic motion system for OMP Switch.
Downloads
| Artifact | Platform | Notes |
|---|---|---|
OMP-Switch-Setup-0.5.0.exe |
Windows x64 | NSIS installer, per-user |
OMP-Switch-0.5.0-win.zip |
Windows x64 | Portable build |
SHA256SUMS.txt |
— | SHA256 verification for both artifacts |
latest.json + latest.json.sig |
— | Signed update manifest (Ed25519) |
The installer and portable build include the Windows DPAPI-backed secret bridge and the packaged
omp-switch-cli.exe. The headless CLI image is published as
ghcr.io/skh2945932142/omp-switch-cli:0.5.0 and :latest.
Highlights
🎨 Apple × OpenAI Hybrid UI/UX Design System
- Dual-Track Theme Hierarchy: Refined dark mode with obsidian charcoal tones (
#0d0d10) and crisp paper white (#fbfbfc) light mode, resolving 100% vialight-dark()CSS tokens. - Windows 11 Mica Glassmorphism: Top bar (56px) and Left Rail sidebar feature
backdrop-filter: blur(16px/20px)to softly reflect desktop backgrounds on Windows 11. - Compact High-Density Lists: Model rows standardized to
40pxheight withtabular-numscontext sizes; Role cards feature clean hop chain visualizations (@default → provider/model). - Segmented Thinking Controls: Replaced native dropdowns with Apple-style segmented buttons for thinking levels.
💫 Fluid Physics & Micro-Haptics
- Drawer Depth Scaling: Main workspace smoothly scales down to
0.992with0.96opacity when floating sheet drawers are active. - Staggered Children Entrance: Cards, metric strips, and list rows glide in with subtle staggered keyframe timing.
- Tactile Touch Feedback: Buttons, cards, and navigation items feature physical press scaling (
scale(0.985)), glowing focus rings, and active left indicator pills. - Command Palette (
Ctrl+K): Added dedicated shortcut trigger in the top bar for rapid navigation and search.
Verify what you downloaded
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-Setup-0.5.0.exe").Hash.ToLower()
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-0.5.0-win.zip").Hash.ToLower()
# Compare both values with SHA256SUMS.txt.
gh attestation verify ".\OMP-Switch-Setup-0.5.0.exe" --repo skh2945932142/omp-switchOMP Switch v0.4.8
OMP Switch v0.4.8
This release adds full compatibility and GUI management for OMP v18.0.0+ settings, including
unexpected stop recovery detection modes and update channel configuration.
Downloads
| Artifact | Platform | Notes |
|---|---|---|
OMP-Switch-Setup-0.4.8.exe |
Windows x64 | NSIS installer, per-user |
OMP-Switch-0.4.8-win.zip |
Windows x64 | Portable build |
SHA256SUMS.txt |
— | SHA256 verification for both artifacts |
latest.json + latest.json.sig |
— | Signed update manifest (Ed25519) |
The installer and portable build include the Windows DPAPI-backed secret bridge and the packaged
omp-switch-cli.exe. The headless CLI image is published as
ghcr.io/skh2945932142/omp-switch-cli:0.4.8 and :latest.
Added
- Unexpected Stop Detection. Added
features.unexpectedStopDetectionselector in the Settings
drawer with support fornone(disabled),mechanical(structural retry, default), andsmart(classifier-backed). - Update Channel. Added
update.channelselection supportingstableandcanaryrelease channels. - Validation & AST Preserving Diff. Core package now fully validates and round-trips OMP v18 configuration keys.
Verify what you downloaded
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-Setup-0.4.8.exe").Hash.ToLower()
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-0.4.8-win.zip").Hash.ToLower()
# Compare both values with SHA256SUMS.txt.
gh attestation verify ".\OMP-Switch-Setup-0.4.8.exe" --repo skh2945932142/omp-switchOMP Switch v0.4.7
OMP Switch v0.4.7
This release introduces direct provider apply from the models sidebar, Apple Settings-inspired
visual hierarchy refinement, and unified spring micro-interactions.
Downloads
| Artifact | Platform | Notes |
|---|---|---|
OMP-Switch-Setup-0.4.7.exe |
Windows x64 | NSIS installer, per-user |
OMP-Switch-0.4.7-win.zip |
Windows x64 | Portable build |
SHA256SUMS.txt |
— | SHA256 verification for both artifacts |
latest.json + latest.json.sig |
— | Signed update manifest (Ed25519) |
The installer and portable build include the Windows DPAPI-backed secret bridge and the packaged
omp-switch-cli.exe. The headless CLI image is published as
ghcr.io/skh2945932142/omp-switch-cli:0.4.7 and :latest.
Added
- Provider quick apply. Permanent action buttons on provider cards to set target provider as
the preferred provider inmodelProviderOrder, immediately saving with atomic write guarantees,
automatic draft merging, and snapshot tracking. - Provider status & block reasons. Automatic detection of missing keys, disabled providers,
and zero models with actionable tooltips.
Changed
- Visual polish & Apple Settings style. Preferred cards use quiet signal indicators instead of
harsh borders. - Drawer motion unification. Removed duplicate CSS sheet animations to eliminate frame jitter
and spring animation conflicts. - Model list expansion. Added smooth opacity and vertical translation during accordion expand.
Verify what you downloaded
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-Setup-0.4.7.exe").Hash.ToLower()
(Get-FileHash -Algorithm SHA256 ".\OMP-Switch-0.4.7-win.zip").Hash.ToLower()
# Compare both values with SHA256SUMS.txt.
gh attestation verify ".\OMP-Switch-Setup-0.4.7.exe" --repo skh2945932142/omp-switch