OK Code v0.24.0

OK Code v0.24.0

Released April 14, 2026.

Included assets

• macOS Apple Silicon desktop build: DMG, ZIP, blockmaps, and latest-mac.yml
• Linux x64 desktop build: AppImage and latest-linux.yml
• Release documentation attachments: changelog, release notes, asset manifest

Pending rollout items

• Windows x64 installer is not attached in this forced release because Azure Trusted Signing secrets are not configured.
• iOS TestFlight upload is pending because the App Store distribution certificate secrets are not configured.
• CLI publish is still pending; npm install -g okcodes@0.24.0 is not live yet.

Summary

Theme presets, markdown rendering unification, project icon support, and active-turn state cleanup.

OK Code v0.23.3

OK Code v0.23.3

Date: 2026-04-13
Tag: v0.23.3

Summary

Patch release to harden desktop migrations and normalize legacy model-selection data.

Highlights

• Format v0.23.2 release files.

Breaking changes

• None.

Upgrade and install

• CLI: npm install -g okcodes@0.23.3 (after the package is published to npm manually).
• Desktop: Download from GitHub Releases. Filenames are listed in assets.md.
• iOS: Available via TestFlight (uploaded automatically by the Release iOS workflow).

Known limitations

OK Code remains early work in progress. Expect rough edges around session recovery, streaming edge cases, and platform-specific desktop behavior. Report issues on GitHub.

Release operations

• Review the asset manifest to confirm every expected GitHub Release attachment is present.
• Use the rollout checklist to walk the coordinated release from preflight through post-release verification.
• Use the soak test plan to validate the highest-risk surfaces after the tag is live.

OK Code v0.23.1

OK Code v0.23.1

Date: 2026-04-13
Tag: v0.23.1

Summary

Desktop and iOS release-readiness update with Codex/Copilot SME support, Gemini provider support, and release-flow fixes.

Highlights

• Feature/claude sme direct auth.
• Add per-project icon overrides.
• Add canonical model selection and Gemini provider.
• Add keyboard shortcuts for panel navigation.
• Run iOS sync from apps/mobile.
• Allow shared-secret openclaw auth without device token.
• Treat error notifications as preview overlays.
• Rename Cotton Candy theme to Purple Stuff.

Breaking changes

• None.

Upgrade and install

• CLI: npm install -g okcodes@0.23.1 (after the package is published to npm manually).
• Desktop: Download from GitHub Releases. Filenames are listed in assets.md.
• iOS: Available via TestFlight (uploaded automatically by the Release iOS workflow).

Known limitations

OK Code remains early work in progress. Expect rough edges around session recovery, streaming edge cases, and platform-specific desktop behavior. Report issues on GitHub.

Release operations

• Review the asset manifest to confirm every expected GitHub Release attachment is present.
• Use the rollout checklist to walk the coordinated release from preflight through post-release verification.
• Use the soak test plan to validate the highest-risk surfaces after the tag is live.

OK Code v0.23.0

OK Code v0.23.0

Date: 2026-04-13
Tag: v0.23.0

Summary

This release expands provider coverage, hardens auth and gateway setup, and cleans up the configuration and review flows needed for the next OK Code release train.

Highlights

• Add GitHub Copilot provider support.
• Add language switcher and Openclaw auth proxy.
• Add API auth seamline and minimal Claude proxy.
• Split SME chat list and add auto-scroll handling.
• Add configurable browser preview start page.
• Add provider availability settings and picker filtering.
• Add in-app browser helper for Tweakcn settings.
• Add hotkey settings editor and keybinding reset support.

Detailed changes

• Providers and auth
  GitHub Copilot support now ships alongside the existing provider stack, and Claude/OpenClaw setup flows received additional auth proxy and token-handling work so provider onboarding is more reliable.
• Settings and configuration
  Provider availability controls, picker filtering, browser preview defaults, and hotkey editing all land in the same train, which makes the settings surface materially more capable without requiring separate follow-up migrations.
• Runtime and review flow
  The PR review dashboard now trims recent review fetches to the smaller operational window we actually need, and the provider runtime event feed coverage was cleaned up so release gating stays predictable.
• Release stability
  Current main release blockers found during local prep were fixed before this train, including the main-branch lint/typecheck regressions that would otherwise have left the branch non-green by default.

Breaking changes

• None.

Upgrade and install

• CLI: npm install -g okcodes@0.23.0 (after the package is published to npm manually).
• Desktop: Download from GitHub Releases. Filenames are listed in assets.md.
• iOS: Available via TestFlight (uploaded automatically by the Release iOS workflow).

Known limitations

OK Code remains early work in progress. Expect rough edges around session recovery, streaming edge cases, and platform-specific desktop behavior. Report issues on GitHub.

Release operations

• Review the asset manifest to confirm every expected GitHub Release attachment is present.
• Use the rollout checklist to walk the coordinated release from preflight through post-release verification.
• Use the soak test plan to validate the highest-risk surfaces after the tag is live.

OK Code v0.22.1

OK Code v0.22.1

Date: 2026-04-10
Tag: v0.22.1

Summary

Ship the 0.22.x patch follow-up with sidebar density controls, richer diagnostics, decision workspace groundwork, stronger OpenClaw plumbing, and desktop and SME workflow polish.

Highlights

• Add sidebar density settings and refresh the default typography and theme tokens across the web app.
• Surface expandable notification diagnostics, copy support, and connection test controls so failures are easier to inspect before retrying.
• Lay the groundwork for decision workspaces with new contracts, persistence, projections, and WebSocket wiring.
• Strengthen provider integrations by extracting the OpenClaw gateway client, adding auth fallback handling, and switching SME Claude flows to Claude Code CLI.
• Polish desktop and chat flows with route-preserving pop-out windows, wider preview viewport inputs, markdown SME replies, and safer diff handling.

Breaking changes

• None.

Upgrade and install

• CLI: npm install -g okcodes@0.22.1 after the package is published to npm.
• Desktop: Download from GitHub Releases. Filenames are listed in assets.md.
• iOS: Available via TestFlight when the coordinated release workflow completes successfully.

Detailed changes

UI density, typography, and navigation polish

• Added sidebar density settings so operators can tighten or relax the navigation layout without changing the existing flow.
• Switched the default web typography to Oxanium and Space Grotesk and refreshed theme tokens to keep the updated chat shell visually consistent.
• Widened preview viewport inputs, preserved the active thread route in desktop pop-out windows, and opened GitHub links from the preview popout in the external browser.
• Replaced the draft upload icon with a close action and kept SME replies rendering as markdown for clearer thread reading.

Diagnostics and action handling

• Added expandable notification details with copy-ready diagnostics so runtime and connection failures can be inspected and shared without digging through logs.
• Added connection test controls in the UI to make provider and transport troubleshooting faster during setup and recovery.
• Added stop support for pending git actions to keep long-running operations interruptible from the existing flow.
• Ignored expected redacted auth shutdown noise in Codex logs and deferred an empty diff guard until after hook setup to avoid false-positive failures.

Decision workspace and companion groundwork

• Added new decision workspace contracts plus server-side persistence layers, migrations, projection services, and WebSocket wiring needed for future consultation workflows.
• Added pending user input projections and thread overview and detail queries so orchestration state can expose richer action context.
• Added companion pairing contracts and mobile pairing stubs, with supporting test updates, to prepare the mobile companion flow for broader session coordination.

Provider and integration updates

• Extracted the OpenClaw gateway client into a dedicated layer with auth fallback support and updated the handshake test to the modern connect flow.
• Switched SME Claude integrations to Claude Code CLI while keeping the provider-auth flow aligned with the current SME experience.
• Normalized React language ids for syntax highlighting so editor and diff rendering stay predictable across React-related file associations.

Release readiness and compatibility fixes

• Restored orchestration snapshot and thread detail compatibility across shared contracts and WebSocket methods so the current server and web builds agree on the runtime payload shape.
• Added a pending user input projection backfill migration so already-upgraded state directories do not fail startup or tests with a missing projection table.
• Improved OpenClaw gateway handshake diagnostics to report websocket-stage versus handshake-stage failures clearly, including pairing-required responses.
• Isolated CLI test state directories to avoid SQLite lock contention during the full local release validation suite.
• Tuned long user-message timeline height estimation so the browser chat layout stays aligned with the validated rendering path.

Maintainer tooling

• Added OpenClaw maintainer workflow skills to support faster GHSA, review, prep, merge, and PR operations.
• Regenerated VS Code icon manifests so shipped file associations and icon metadata stay aligned with the repo sources.
• Added planning docs for sidebar and LM Studio follow-up work without changing the current release behavior.

Release verification references

• Review the asset manifest to confirm every expected GitHub Release attachment is present.
• Use the rollout checklist to walk the coordinated release from preflight through post-release verification.
• Use the soak test plan to validate the highest-risk surfaces after the tag is live.

Known limitations

OK Code remains early work in progress. Expect rough edges around session recovery, streaming edge cases, and platform-specific desktop behavior. Report issues on GitHub.

OK Code v0.22.0

OK Code v0.22.0

Date: 2026-04-09
Tag: v0.22.0

Summary

Ship provider-aware SME conversation auth, refresh the SME chat and settings experience, and harden websocket error redaction across the app.

Highlights

• Persist provider and auth method per SME conversation so sends can be validated against the right backend.
• Refresh the SME workspace with a modern sidebar, auto-sizing composer, and tighter message presentation.
• Restructure settings into navigable sections with clearer headers and mobile section picking.
• Redact secrets from websocket errors in the server, transport, and UI paths.

Breaking changes

• None.

Upgrade and install

• CLI: npm install -g okcodes@0.22.0 after the package is published to npm.
• Desktop: Download from GitHub Releases. Filenames are listed in assets.md.
• iOS: Available via TestFlight when the coordinated release workflow completes successfully.

Detailed changes

Security and error handling

• Added shared redaction helpers and applied them to websocket server, transport, and UI error presentation so secrets stay out of surfaced errors and logs.
• Covered the redaction behavior with unit tests to keep error handling predictable as message shapes change.

SME conversation auth

• Persisted provider and auth method per SME conversation so the app can route messages through the correct backend after validation.
• Added the validation and provider-runtime plumbing needed to dispatch SME sends through Anthropic or the provider runtime path.
• Introduced an edit dialog and supporting store/config updates so conversation settings can be changed without leaving the workspace.
• Added a persistence migration for the new conversation auth fields.

SME chat UX

• Reworked the SME workspace with a cleaner sidebar, better empty/loading states, a more usable composer, and improved message bubble hierarchy.
• Updated the conversation rail and knowledge panel spacing and actions so longer sessions remain easier to scan.

Settings navigation

• Split settings into section-specific panels and added sidebar plus mobile section pickers for faster navigation.
• Updated the settings header to reflect the active section and added descriptions to make each panel easier to understand at a glance.

Release verification references

• Review the asset manifest to confirm every expected GitHub Release attachment is present.

Known limitations

OK Code remains early work in progress. Expect rough edges around session recovery, streaming edge cases, and platform-specific desktop behavior. Report issues on GitHub.

OK Code v0.21.0

OK Code v0.21.0

Date: 2026-04-09
Tag: v0.21.0

Summary

This release focuses on continuity and release readiness: faster terminal startup, more predictable thread/project behavior, stronger SME auth recovery, and release metadata aligned for the full v0.21.0 train.

Highlights

• Centralize desktop renderer URL resolution for packaged and development shells.
• Reduce terminal session startup latency with shared runtime environment resolution and a new terminal session controller path.
• Archive older project threads when project limits are enforced instead of leaving project state ambiguous.
• Preserve local draft threads across project switches so in-progress work survives navigation.
• Resolve SME chat Anthropic authentication from persisted environment state.
• Simplify thread mode controls to code and plan.
• Add broad regression coverage for cleanup, connection health, readiness, and draft/session flows.
• Update iOS release metadata, including team wiring, display name handling, and Info.plist settings.

Breaking changes

• None.

Upgrade and install

• CLI: npm install -g okcodes@0.21.0 after the coordinated release workflow publishes the package.
• Desktop: Download from GitHub Releases. Attached filenames are summarized in assets.md.
• iOS: Available via TestFlight when the coordinated release workflow completes successfully.

Change details

Desktop and packaging

• Moved renderer URL resolution into a shared desktop helper and added regression coverage for packaged and development startup paths.
• Kept the desktop shell aligned with the web entrypoint so the packaged renderer loads predictably during release builds.

Session continuity and project behavior

• Preserved local draft threads when switching between projects, avoiding accidental loss of in-progress conversations.
• Archived project threads when enforcing project limits so older threads stop competing with active project state.
• Simplified chat mode selection down to code and plan to match the current supported interaction model.
• Improved hidden-workspace behavior by collapsing the tree vertically instead of leaving empty reserved space.
• Polished sidebar accent handling for project names so visual treatment stays consistent across projects.

Runtime reliability and regressions

• Reduced terminal startup latency by resolving runtime environment data earlier and reusing it across the terminal launch path.
• Fixed SME Anthropic auth recovery to load persisted environment values instead of failing after restarts or reloads.
• Removed a stale closure issue in the SME chat shell that could leave the view bound to outdated state.
• Added regression coverage around cleanup flows, connection health, readiness checks, native folder picking, merged-thread cleanup, and terminal/session orchestration.

Mobile metadata

• Updated iOS project metadata for the release train, including team settings, display name handling, and Info.plist release values.

Known limitations

OK Code remains early work in progress. Expect rough edges around session recovery, streaming edge cases, and platform-specific desktop behavior. Report issues on GitHub.

OK Code v0.20.0

OK Code v0.20.0

Date: 2026-04-09
Tag: v0.20.0

Summary

Polish the sidebar app shell, stabilize SME chat and OpenClaw gateway flows, and keep release metadata aligned.

Highlights

• Turn the sidebar footer brand block into a clickable home/status affordance.
• Add OpenClaw gateway auth timeout diagnostics.
• Use default tree for new chats and show stash badges.
• Reuse stable empty message array in SME chat.
• Refresh sidebar branding and align package versions.
• Refresh sidebar app footer branding.

Breaking changes

• None.

Upgrade and install

• CLI: npm install -g okcodes@0.20.0 (after the package is published to npm manually).
• Desktop: Download from GitHub Releases. Filenames are listed in assets.md.
• iOS: Available via TestFlight (uploaded automatically by the Release iOS workflow).

Known limitations

OK Code remains early work in progress. Expect rough edges around session recovery, streaming edge cases, and platform-specific desktop behavior. Report issues on GitHub.

OK Code v0.19.0

OK Code v0.19.0

Date: 2026-04-08
Tag: v0.19.0

Summary

Harden the release pipeline, clean up branch-handling around PR creation, and remove the release-preflight blockers that were slowing down the rollout path.

Highlights

• Make the release workflow more resilient. Release documentation staging, optional CLI publication, and post-release version updates now have clearer guardrails.
• Fix branch metadata handling. Push and PR creation no longer trip over stale or mismatched branch data during release-related flows.
• Clear the release-preflight blockers. Server snapshot decoding and strict type-check issues are fixed so the release gate can stay green.
• Keep the release bundle tidy. The release notes, asset manifest, and changelog now line up with the attached release artifacts.

Detailed changes

Release flow

• Improved release workflow resilience around staged release documentation.
• Made optional CLI publishing less fragile during the coordinated release process.
• Tightened the finalize path so version bump handling stays predictable after publish.

Git and PR handling

• Fixed stale branch metadata so push and PR creation use the right branch context.
• Improved release-related branch resolution when the active workspace and upstream refs diverge.

Preflight cleanup

• Fixed snapshot query handling for thread githubRef data.
• Fixed wsServer.ts type issues blocking strict server typecheck.
• Fixed formatting drift and release-preflight blockers discovered during rollout.

Breaking changes

• None.

Upgrade and install

• CLI: npm install -g okcodes@0.19.0 when the package is published.
• Desktop: Download from GitHub Releases. Filenames are listed in assets.md.
• iOS: Available via TestFlight when the coordinated release workflow completes with signing enabled.

Release verification references

• Review the asset manifest to confirm every expected GitHub Release attachment is present.
• Use the rollout checklist for preflight, publish, and post-release verification.

Known limitations

OK Code remains early work in progress. Expect rough edges around session recovery, streaming edge cases, and platform-specific desktop behavior. Report issues on GitHub.

OK Code v0.18.0

OK Code v0.18.0

Date: 2026-04-07
Tag: v0.18.0

Summary

Strengthen the day-to-day workspace experience with a unified right-sidebar workspace panel, more capable preview controls, broader worktree cleanup actions, and a safer release train for the CLI and web surfaces.

Highlights

• Add a dedicated workspace panel in the right sidebar. Projects, files, and related workspace context now live in one predictable panel that is faster to scan and easier to keep open while reviewing or editing.
• Make preview workflows more flexible. Preview layout modes, pop-out controls, top-docked preview behavior, and tab snapshot capture make it easier to compare app states without losing orientation.
• Expand worktree cleanup controls. Teams can now run bulk delete-all cleanup flows and manage larger sets of disposable worktrees without repeated one-off cleanup actions.
• Improve navigation and rendering stability. Cached sidebar lookups and reduced preview/diff flicker keep the UI steadier under frequent thread, project, and panel updates.
• Handle richer project files. Binary project writes are now supported, with workspace tree behavior updated to stay readable around non-text assets.
• Harden release operations. The coordinated release workflow now treats CLI publication as optional when needed, and the web release path no longer emits the warnings that previously weakened ship confidence.

Detailed changes

Workspace and navigation

• Added a unified workspace panel to the right sidebar.
• Added a project-sidebar expand-all control for faster tree browsing.
• Open diff files directly in the integrated viewer.
• Cached sidebar thread and project lookups to reduce repeated navigation work.
• Moved sidebar branding to the footer and removed the chat project badge to keep the header focused on active work.
• Cleaned up chat header panel toggles for a simpler control surface.

Preview and review ergonomics

• Added preview layout modes so users can choose the right comparison layout for the task at hand.
• Added preview pop-out controls for workflows that need more room or separate windows.
• Locked browser preview positioning to the top dock for more predictable layout behavior.
• Added tab snapshot capture for preview tabs.
• Reduced preview and diff flicker during frequent workspace updates.

Worktrees and project files

• Added a bulk delete-all worktree cleanup action.
• Added support for binary project writes.
• Collapsed the workspace tree more intelligently when binary-write contexts are shown so large file sets stay manageable.

Release reliability

• Made CLI publishing optional in the coordinated release workflow so desktop and documentation assets can still ship when npm publication needs to be deferred.
• Fixed web release warnings to keep the release path clean before tagging.

Breaking changes

• None.

Upgrade and install

• CLI: npm install -g okcodes@0.18.0 when the coordinated release publishes the package.
• Desktop: Download from GitHub Releases. Filenames and attachment classes are listed in assets.md.
• iOS: Available via TestFlight when the coordinated release workflow completes with signing enabled.

Release verification references

• Review the asset manifest to confirm every expected GitHub Release attachment is present.
• Use the rollout checklist for preflight, publish, and post-release verification.
• Use the soak test plan if an RC is cut or if the team wants targeted verification of the new workspace and preview flows.

Known limitations

OK Code remains early work in progress. Expect rough edges around session recovery, streaming edge cases, and platform-specific desktop behavior. Report issues on GitHub.