Skip to main content

Helix Update History

New release notes should be inserted at the top of this file during each release.

v1.0.29 · 2026-03-19​

Summary​

  • Helix adds full image support: drag-and-drop upload, lightbox preview, and tool-result image rendering. Thinking-mode button redesigned, stream flicker fixed, and history pre-load sped up.
  • Helix-agent adds image support in tool results across all providers and passes images through sub-agent pipelines; fixes multiple longterm-chat data-loss bugs and adds SSH keepalive timeout protection for Remote MCP.

Helix​

  • Added drag-and-drop image upload from Finder / Explorer directly into the chat input area.
  • Tool result message cards now render images returned by tools.
  • Added lightbox tap-to-expand preview for images in the chat.
  • Redesigned thinking-mode button as a capsule with clearer visual weight; balanced-mode icon and label improved.
  • Added bilingual (zh/en) i18n support for effort-level labels in the chat page.
  • Fixed stream-end full-refresh causing visible flicker after a response completes.
  • Fixed three bugs where switching models after creating a new session had no effect.
  • Fixed sub-agent interruptions incorrectly inheriting the manager's model / thinking / effort parameters.
  • Fixed macOS file picker silently failing in multi-window mode.
  • Fixed manager cold-start not pre-seating currentSession, causing AgentSelectorHeader to be invisible on launch.
  • Fixed {name} placeholder not being replaced in the workspace-connecting dialog.
  • Fixed account balance incorrectly showing "Unlimited" when the balance was negative.
  • Increased background history pre-load limit to 5 000 to reduce incremental prepend batches and scroll jitter.

Helix-agent​

  • Added image support for tool results: all providers now forward image data, and results are pushed to the frontend via WebSocket.
  • Images are now passed through longterm_chat and run_subagent pipelines to sub-agents.
  • Fixed two longterm-chat data-loss bugs: cancel-propagation incorrectly dropped interject-queue messages; a race window caused saves to be skipped when a session was stopping.
  • Fixed manager cancel not propagating to running sub-agents, leaving orphaned goroutines.
  • Fixed UpdateMCPConfigWithServers rebuilding the runner without restoring message history, overwriting disk history on restart.
  • Fixed API-mode interject truncating an active sub-agent task execution flow.
  • Fixed CLI-mode interject messages being silently dropped.
  • Prevented mid-loop model switching during Phase 2/3 tool cycles to avoid history truncation and persistence loss.
  • Removed sub-agent code-review guidance from coderSystemPrompt to reduce unnecessary nested agent calls.
  • Added SSH keepalive timeout protection for Remote MCP to prevent infinite hangs on dropped connections.

Repository commits​

  • agentui: 3fb56fa2779b69a40298152920753dcb8ee064e3
  • aiagent: 55fd9c82a7dd3f89e8f53bdeb92edbe31dc1d97a

v1.0.28 · 2026-03-17​

Summary​

  • Helix adds Windows support with bundled Helix-agent auto-start, a backend status panel, redeem code top-up, background history pre-loading, and various UX fixes.
  • Helix-agent adds Windows PTY support via ConPTY for native terminal experience on Windows.

Helix​

  • Windows: bundled Helix-agent now auto-starts on launch; added backend status indicator and log panel on Windows.
  • Added redeem code top-up in the personal center.
  • Fixed top-up redirect URL path (/api/user/topup).
  • Redeem success prompt now displays the credited amount in USD.
  • Added device management page with full bilingual (zh/en) i18n support.
  • Background history pre-loading: chat history pages are now pre-fetched in the background for faster navigation.
  • Fixed tunnel URL usage across all pages when connected via tunnel (was incorrectly using direct URL).
  • Tunnel list now isolated per machine by nodeId.
  • Fixed provider card not auto-expanding after creation; added inline form validation.
  • Fixed macOS Dock icon showing black ring; updated app icon to new rounded design.
  • Fixed mobile chat message avatar and padding being oversized on small screens.
  • Android: added release signing configuration.

Helix-agent​

  • Added Windows PTY support via ConPTY, providing native terminal emulation on Windows (Unix/macOS unchanged).
  • Fixed pairing/status response missing gateway_node_id field.

Repository commits​

  • agentui: dfd8dc8cb74429a47c26ca7db28a26830bdd6283
  • aiagent: 1f3e19f2f74db88ba39ff2ea790d90a5311791fa

v1.0.18 · 2026-03-16​

Summary​

  • Helix overhauls the full tunnel URL pipeline so all connections use live, up-to-date tunnel addresses; adds new branding assets, scroll-to-top button, and multi-line log copy.
  • Helix-agent fixes background task routing races, prevents 0-byte session files on crash, and adds lanproxycore auto re-enrollment on authentication failure.

Helix​

  • Overhauled the full tunnel URL pipeline: ApiService, WebSocket, workspace connection, and credential binding now all use the live tunnel URL from the cloud, fixing cross-device 401 errors and stale-port issues.
  • Tunnel connection info is now stored and synced to cloud; soft-deleted devices can be recovered during sync.
  • Server selector now displays tunnel URL instead of direct IP; tunnel status refreshes in the background with proper concurrency safety.
  • Tunnel URL is no longer statically cached — the latest port is fetched from cloud before connecting and after sync.
  • Fixed connectWorkspace to match synced entries by nodeId, preventing cross-device tunnel URL pollution.
  • Fixed multi-device conflict where the same serverUrl across multiple devices overwrote each other; now keyed by nodeId:serverUrl.
  • Local 127.0.0.1 services always use direct connection and never route through tunnel.
  • Fixed macOS orphaned backend process on window close; ensures proper NSApp.terminate() on last window close.
  • Fixed a Swift API rename error (replyToApplicationShouldTerminate).
  • Replaced all platform icons with the new transparent Helix logo.
  • Added scroll-to-top button and hides scrollbar during streaming for a cleaner chat experience.
  • Restored auto-scroll broken by a previous streaming optimization.
  • Optimized sub-dialog window rendering to streaming-only mode for better performance.
  • Fixed session list debounced sort, scroll freeze, and animated reorder.
  • Log panel now supports multi-line selection and copy.
  • Fixed Shift/Cmd/Ctrl+Enter inserting line break in Enter-to-send mode; IME composing now prevents accidental message send.
  • Added backward compatibility for HTTP 404 on cloud device management for legacy backends.

Helix-agent​

  • Fixed ClearedMarkerJSON to emit valid JSON with defensive json.Valid guard.
  • Fixed background task routing and session rendering issues.
  • Fixed MCP config update overwriting session message history on app restart.
  • Fixed background task sessionID race that caused results to route to the wrong session.
  • Fixed background task Path C missing TaskStarted event and added post-completion queue recovery.
  • Added atomic file writes for session persistence to prevent 0-byte files after crash.
  • Fixed lanproxycore to auto re-enroll when authentication fails to obtain a new token.

Repository commits​

  • agentui: bf609c85522c568abada7d757e638a61f9ca4546
  • aiagent: 951dc8efa34d4a5a3e7b40bdd1763b52f1a984fb

v1.0.16 · 2026-03-15​

Summary​

  • Helix adds a gateway-based exposure management UI, restructures subagent drill-down into nested dialogs, and introduces a background task panel with real-time progress tracking.
  • Helix-agent adds background shell execution with auto-result injection, persists tool link metadata for subagents and longterm sessions, and fixes several subagent callback routing issues.

Helix​

  • Added gateway-based exposure management UI for controlling port visibility directly from the interface.
  • Unified subagent drill-down as nested dialogs, replacing the previous page-navigation approach for a more fluid experience.
  • Added background task UI with a management panel showing task status and history.
  • Restored tool links from backend metadata so subagent dialog entries survive session reload.
  • Refactored MCP server card to compact single-row layout with bottom-sheet detail view.
  • Overhauled MCP panel UI with segmented buttons, dynamic headers, status badges, and better empty states.
  • Improved long conversation rendering performance.
  • Restored line-break preservation when copying rendered markdown.
  • Fixed subagent dialog binding to existing run_subagent cards using tool call ID.
  • Fixed longterm badge rendering from history and guarded against nullable click handlers.
  • Fixed subagent chat page interaction flow and longterm overlay white-screen regressions.
  • Localized manager default agent template settings.
  • Removed the model refresh icon from the chat toolbar for a cleaner layout.

Helix-agent​

  • Added background shell execution with auto-result injection into the conversation flow.
  • Persisted tool link metadata for longterm and subagent sessions so links survive restarts.
  • Added context cache cleared zone and exclude_tools support.
  • Fixed subagent tool call ID propagation through the WebSocket pipeline.
  • Fixed flaky subagent callback routing.
  • Fixed background task delivery and visibility issues, including reqID filtering and longterm task handoff.
  • Fixed history session message and tool_links disk fallback loading.
  • Fixed longterm session SubAgentStatus persistence for frontend dialog recovery.
  • Removed deprecated dual-agent feature and built-in port-forward MCP.
  • Reuse canonical history on cross-provider model switch.

Repository commits​

  • agentui: 3c5df1e94d1e617702f5514198097649de39a7c9
  • aiagent: 3a365cbcf1d3f77fcbd341a0f0a86de8b4273299

v1.0.15 · 2026-03-13​

Summary​

  • Helix streamlines the chat workspace by removing the duplicate dual-agent entry point and polishing several interaction details across overlays, toolbars, and settings.
  • Helix-agent fixes stale-context cleanup when a manual compression cancellation is triggered, improving recovery during interrupted compression flows.

Helix​

  • Removed the duplicate dual-agent chat entry to simplify the main chat experience.
  • Improved the manual compression cancellation message so stale-context recovery feedback is clearer.
  • Added support for showing the long-chat overlay correctly inside nested subagent views.
  • Simplified the modern toolbar visuals and reorganized Settings by scope for a cleaner interface.

Helix-agent​

  • Fixed stale-context cancellation handling during manual compression cancellation.

Repository commits​

  • agentui: 84200d44be99d14e4cc9ee7bf3906ba4ef34cc2f
  • aiagent: c8c97ea134bd7a9ff59c2b4c0941455e0a26539d

v1.0.14 · 2026-03-13​

Summary​

  • Helix improves final session refresh handling so memory fallback and compression state recovery stay stable at the end of a conversation.
  • Helix-agent fixes final session persistence timing and updates GPT-5 Responses requests to use the priority service tier for more reliable execution.

Helix​

  • Fixed final session refresh memory fallback behavior to reduce the chance of losing recovered context during the last refresh step.
  • Hardened final refresh compression state checks so compressed chat state stays consistent when a session is being finalized.

Helix-agent​

  • Fixed a final session persistence race to make end-of-session saves more reliable.
  • Updated GPT-5 Responses payload handling to use the priority service tier, with matching test coverage for the new request shape.

Repository commits​

  • agentui: ca021b9b0342605e2535b4d5f6831a6118b6f99d
  • aiagent: 287d0461d5ef375d35601b344364bc3f23b94a7d

v1.0.13 · 2026-03-13​

Summary​

  • Helix now checks release and upgrade information against the active workspace backend, so version status matches the server you are actually using.
  • Helix-agent improves Windows shell fallback behavior and removes unsupported Responses API context parameters for more reliable command execution and model compatibility.

Helix​

  • Scoped Settings version and upgrade checks to the current workspace backend instead of a global service instance.

Helix-agent​

  • Fixed Windows execute_shell fallback to use the standard cmd.exe /d /s /c invocation with safer command escaping.
  • Removed unsupported Responses API context parameters and emit a warning when deprecated auto_compact_token_limit config is still present.

Repository commits​

  • agentui: e3645236e55891c7631a8fff1888c68334d21871
  • aiagent: 61abff7a5a266f98b705fc64bba3592611555bf2

v1.0.12 · 2026-03-13​

Summary​

  • Improved the PTY session creation flow in Helix to make terminal startup clearer and easier.
  • Updated Helix-agent shell execution so execute_shell uses the correct platform-native shell automatically, including Windows support.

Helix​

  • Improved the PTY session creation dialog UX to make setup clearer and reduce friction when starting terminal sessions.

Helix-agent​

  • Updated execute_shell to select the correct platform-native shell automatically, improving cross-platform command execution behavior.

Repository commits​

  • agentui: 952a33873f31d23ecad895306704fc727d809828
  • aiagent: 0a58727ced17dd31398d6eeabbc06068bab28a2b

v1.0.11 · 2026-03-12​

Summary​

  • Improved compressed chat handling so Web and backend recovery stay consistent during websocket error flows.
  • Updated the Helix login flow to use the fixed production service URL.
  • Refreshed Helix dependency lockfile versions for the current release build.

Helix​

  • Fixed the auth dialog to use the fixed Helix service URL.
  • Restored compression state after websocket errors to keep frontend chat behavior stable.
  • Refreshed Flutter dependency lockfile versions for the current build.

Helix-agent​

  • Preserved compression semantics and corrected status mapping behavior in backend handlers.

Repository commits​

  • agentui: 94a69c46c7033cb28d3dd2419d7921d55cc9004c
  • aiagent: 67362122f6aafef192eafe31f6b3202f5ea7c14b

v1.0.10 · 2026-03-12​

Summary​

  • Initial published baseline for Helix and Helix-agent release notes.

Helix​

  • No user-facing changes in this repository for this release.

Helix-agent​

  • No user-facing changes in this repository for this release.

Repository commits​

  • agentui: 3e522dda5f2f024d437e1b436836243e6e51c845
  • aiagent: f005e86d9785cf8dbad23f59fdf871862f843c0b