This release includes 1 breaking change for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
+2 more
Affected surfaces
ReleasePort's take
Moderate signalThe catalog system now uses SQLite instead of JSON files by default. This change impacts storage and retrieval mechanisms.
Why it matters: Affects any code or scripts interacting with the catalog; migration to SQLite is automatic but requires verifying compatibility for version v0.5.2 releases.
Summary
AI summaryUpdates Bug Fixes, New Features, and Chores across a mixed release.
Changes in this release
| Type | Severity | Summary | CVE |
|---|---|---|---|
| Breaking | High |
Catalog storage migrates from JSON files to SQLite by default. Catalog storage migrates from JSON files to SQLite by default. Source: llm_adapter@2026-07-12 Confidence: high |
— |
| Feature | Medium |
Adds OpenRouter provider support with cost-based routing and catalog-driven model resolution. Adds OpenRouter provider support with cost-based routing and catalog-driven model resolution. Source: llm_adapter@2026-07-12 Confidence: high |
— |
| Feature | Medium |
Adds --provider flag to init command for generating provider-specific config templates. Adds --provider flag to init command for generating provider-specific config templates. Source: llm_adapter@2026-07-12 Confidence: high |
— |
| Feature | Medium |
Implements SQLite-based storage for performance metrics, request tracking, and log management. Implements SQLite-based storage for performance metrics, request tracking, and log management. Source: llm_adapter@2026-07-12 Confidence: high |
— |
| Feature | Medium |
Adds macOS GUI support with systray integration. Adds macOS GUI support with systray integration. Source: llm_adapter@2026-07-12 Confidence: high |
— |
| Feature | Medium |
Adds catalog synchronization with automatic syncing and configuration options. Adds catalog synchronization with automatic syncing and configuration options. Source: llm_adapter@2026-07-12 Confidence: high |
— |
| Feature | Medium |
Adds catalog stats endpoint for monitoring status and statistics. Adds catalog stats endpoint for monitoring status and statistics. Source: llm_adapter@2026-07-12 Confidence: high |
— |
| Dependency | Low |
Updates dependencies in go.mod and go.sum for improved functionality and performance. Updates dependencies in go.mod and go.sum for improved functionality and performance. Source: llm_adapter@2026-07-12 Confidence: high |
— |
| Bugfix | Medium |
Improves error messages and streamlines output in models list command. Improves error messages and streamlines output in models list command. Source: llm_adapter@2026-07-12 Confidence: high |
— |
| Bugfix | Medium |
Adjusts percentile index calculations to handle edge cases in latency metrics. Adjusts percentile index calculations to handle edge cases in latency metrics. Source: llm_adapter@2026-07-12 Confidence: high |
— |
Full changelog
Release Notes
This release introduces major architectural improvements with SQLite-based storage for the catalog system, adds OpenRouter provider support with cost-based routing capabilities, and enhances the CLI with provider-specific initialization templates. The catalog migration from JSON to SQLite improves performance and reliability while maintaining backward compatibility.
⚠️ Breaking Changes
- Catalog Storage Migration: The catalog system now uses SQLite by default instead of JSON files. Existing JSON catalogs will be automatically migrated on first run. Manual JSON catalog files in the configuration directory should be removed after migration completes.
New Features
- Add OpenRouter provider support with catalog-driven model resolution and cost-based routing
- Add --provider flag to init command for generating provider-specific config templates (opencode-go, opencode-zen, aws-bedrock, openrouter)
- Implement SQLite-based catalog storage to replace JSON file storage
- Add cost-based routing with provider penalties and context window limits
- Add catalog synchronization with automatic syncing and configuration options
- Add catalog stats endpoint for monitoring catalog status and statistics
- Implement macOS GUI support with systray integration
- Add SQLite storage for performance metrics, request tracking, and log management
- Add catalog migration function from JSON to SQLite with backward compatibility
Bug Fixes
- Add missing period in error message for catalog not found
- Improve error messages and streamline output in models list command
- Adjust percentile index calculations to handle edge cases in latency metrics
- Update config path in TestRoute_LegacyConfigFixtures for consistency
- Update ResolveShort documentation to clarify matching logic and provider prioritization
Improvements
- Enhance ModelRouter to support catalog-based model resolution
- Improve model resolution to handle unknown providers and ambiguity
- Enhance provider model index creation and synchronization in catalog
- Add automatic catalog reloading in ModelRouter
- Enhance SelectCheapest and providerSet with effective penalties and preferred provider logic
- Add debug logging to BuildProviderIndex for provider and model samples
- Enhance performance metrics handling with improved latency calculations and success counts
- Refactor StorageWriter interface for better storage integration
- Update cost calculation in resolvedModel function to use model-specific values
Documentation
- Add Fedora 44 setup guide to documentation
- Add catalog schema documentation with key fields and model resolution details
- Update documentation for model addition process and cost-based routing details
- Document --provider flag for init command in Quick Start, CLI Commands, and Configuration docs
Chores
- Default to CGO_ENABLED=0 for build in Makefile (browser-based UI)
- Remove system tray for Linux, use web portal only
- Update golangci-lint configuration to enable additional linters
- Remove duplicate entry for .worktrees/ in .gitignore
- Update dependencies in go.mod and go.sum for improved functionality and performance
- Clean up whitespace in migration and performance handling code
Breaking Changes
- Catalog Storage Migration: The catalog system now uses SQLite by default instead of JSON files. Existing JSON catalogs will be automatically migrated on first run; manual JSON catalog files should be removed after migration completes.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
Track Oc-go-cc, an Open-source proxy that lets Claude Code use OSS models
Get notified when new releases ship.
Sign up freeAbout Oc-go-cc, an Open-source proxy that lets Claude Code use OSS models
All releases →Related context
Earlier breaking changes
- v0.6.0 Configuration format updated; migration required for compatibility.
- v0.3.0 Anthropic model routing now prioritizes Zen-specific endpoints over legacy Anthropic when `IsZen` is true; existing configs may need updates using `model_overrides`.
- v0.3.0 `model_overrides` now requires explicit model names for DeepSeek V4 Pro and Flash Free variants; shorthand syntax removed.
- v0.2.9 Removes models mimo-v2-pro, mimo-v2-omni, qwen3.5-plus from routing
- v0.2.8 Breaks existing API key management workflows requiring round-robin configuration
Beta — feedback welcome: [email protected]