Skip to main content

Helix Update History

v1.5.4 · 2026-06-08

Summary

  • Helix: no changes
  • Helix-agent: fix tool call ID mismatch in Responses API to ensure function_call and function_call_output are correctly paired

Helix-agent

  • Fix: use correct CallId (not Item ID) for function_call in Responses API, ensuring tool call pairs match correctly

Repository commits

  • aiagent: f2f7737

v1.5.3 · 2026-06-07

Summary

  • Helix: international edition BYOK model management, subscription UI overhaul (stacked subscriptions, bilingual subtitles, Stripe/WeChat/Alipay unified), streaming message rendering stabilization, thinking controls in chat details, account center subscription UX improvements
  • Helix-agent: Helix international model policy, BYOK model support, unified reasoning_effort passing, config-based model switch detection, context cache threshold fix, compressed history preservation in live views

Helix

  • Feat: international edition BYOK (Bring Your Own Key) model management — import, list, edit, presets
  • Feat: subscription purchase via Stripe/WeChat Pay/Alipay, unified with credit top-up flow
  • Feat: stacked active subscriptions display (count, total progress, per-plan details)
  • Feat: localized subscription subtitles (bilingual zh/en) with visual upgrades (gradient cards, guidance chip)
  • Feat: always show thinking/effort controls in chat details panel (not limited to pro mode)
  • Feat: activate free subscription directly from account center
  • Feat: show subscription credit refresh time and deduction order
  • Feat: display subscription purchase (not 0 credit) in payment records
  • Perf: throttle streaming message rendering at 120ms to reduce unnecessary rebuilds
  • Perf: preserve user message images consistently across optimistic rendering/WebSocket/HTTP
  • Perf: international account center — re-claim expired free plan, recharge entry, refresh hint
  • Perf: remove stale progress indicator from finished Manager sessions
  • Perf: hide Dream sessions from chat lists
  • Perf: build Windows installer as international edition
  • Fix: remove duplicate subtitle sources — consolidate into unified l10n
  • Fix: fall back to AppLocalizations.get(key) for unknown subtitle keys

Helix-agent

  • Feat: Helix international model policy endpoint and policy application (compression, background models, defaults)
  • Feat: BYOK model support with model presets API
  • Feat: pass reasoning_effort uniformly for all thinking models (not limited to DeepSeek V4)
  • Feat: enable Codex headers by default in OpenAI Responses client
  • Perf: detect model switch by config-based ProviderType instead of name heuristics
  • Perf: honor context cache token threshold percentage caps
  • Perf: report longterm context window usage correctly
  • Perf: preserve compressed history in live message views
  • Perf: apply Helix model policy to compression and background model config
  • Fix: fix tool_choice for thinking requests
  • Fix: fix tool_choice for Helix model aliases
  • Fix: fix stale session models and response timeouts

Repository commits

  • agentui: 3244ff7
  • aiagent: a6fb2d8
  • helix-vm: ed7d186(no changes)

v1.5.1 · 2026-06-02

Summary

  • Helix: account center UI redesign, lightweight composer input, focused mode collapse and tool name localization, workspace file transfer menu, Pipe channel binding UI, bilingual support P0-P2
  • Helix-agent: Pipe bidirectional messaging (Telegram provider), general sub-agent dedicated model config, workspace file transfer endpoints, bilingual support, cross-platform FirstSSE timing

Helix

  • Feat: account center UI redesign — grouped display for identity, assets/usage, workspace, and security
  • Feat: Pipe channel settings UI with session binding menu
  • Feat: workspace file browser right-click upload/download menu
  • Feat: editor line wrap toggle
  • Feat: Claude Opus 4.8 preset and default model selector
  • Feat: bilingual support P0-P2 — locale-aware Prompt names and hardcoded string fixes
  • Feat: auto-reload builtin prompts after workspace connect
  • Perf: lightweight single-layer composer input
  • Perf: focused mode collapse intermediate process, show only user input and final response
  • Perf: focused active tool display name localization (Chinese/English)
  • Perf: compact chat details panel density for desktop
  • Perf: compressed history summary divider line "History compressed"
  • Perf: persist pinned session section collapse state
  • Perf: collapse RPM/TPM metrics by default in account center
  • Perf: general sub-agent model config panel
  • Perf: open file sync at current workspace by default
  • Perf: simplified chat page for regular users
  • Perf: mobile chat layout and tunnel workspace access
  • Perf: localized prompt badge labels
  • Fix: show background task count in focused title
  • Fix: session list new chat label layout
  • Fix: chat workspace switch header
  • Fix: workspace event WebSocket prefetch guard (prevent extra WS clients)
  • Fix: selfhost binding visibility in workspace selector
  • Fix: selfhost cloud sync URL retention
  • Fix: macOS menu bar window lifecycle
  • Fix: code editor hardware keyboard input fallback
  • Fix: resolved synced workspace ID path issues
  • Fix: tool panel no longer reopens on window resize
  • Fix: left-align focused tool summaries

Helix-agent

  • Feat: Pipe bidirectional messaging — Telegram provider, session binding
  • Feat: general sub-agent dedicated model config
  • Feat: workspace file transfer endpoints (/api/workspaces/:id/fs/upload|download) with path traversal protection
  • Feat: bilingual support P0-P1 — English prompt names and role prefixes
  • Feat: Claude Opus 4.8 builtin model config
  • Feat: FirstSSE timing — distinguish stream speed from text transfer latency
  • Feat: sandbox shell probe entry
  • Perf: automatic retry for transient Responses stream errors
  • Perf: detailed Token Usage logging for non-thinking paths and compression cost
  • Perf: increased DeepSeek V4 max output tokens
  • Perf: deterministic JSON serialization for Responses cache hit rate
  • Perf: builtin model metadata no longer authoritative
  • Perf: LLM request payload metrics logging
  • Perf: improved response cache debugging and messaging
  • Perf: default file sync to workspace path
  • Fix: Gitea Agent mention gating
  • Fix: preserve accepted job comments in Gitea Agent task flow
  • Fix: Pipe webhook route deduplication
  • Fix: bypass system proxy for LLM Responses client
  • Fix: pass SerenaDataDir to serena-go to keep project dirs clean

Repository commits

  • agentui: 9f5f3fb
  • aiagent: 2f87005
  • helix-vm: ed7d186

v1.5.0 · 2026-05-24

Summary

  • Helix: three-state display mode (full/concise/focused), focused mode text-boundary collapse, Gitea collaboration mode, Tour onboarding guide system, mobile personal center optimization, Android Kotlin DSL migration
  • Helix-agent: workspace-scoped learned skills, ShellGuard safety execution, retry-from-interruption flow, Dream lock mtime split, Gitea Agent MCP tool set

Helix

  • Feat: Chat three-state display modes (full/concise/focused), focused process summaries with active tool retention, timeline detail expansion
  • Feat: focused mode text-boundary collapse, trailing latest-2 display, suppressThinking support
  • Feat: Gitea collaboration mode UI — Auto mode panel, standalone Gitea Agent page, workspace binding, Agent setup wizard
  • Feat: Tour onboarding guide system — guided first-time session, input area, and settings discovery
  • Feat: Retry-from-interruption UI for reconnection recovery
  • Feat: built-in balance warning in settings
  • Feat: Gitea Agent token management UI — multi-token list, role selector, manual revocation
  • Perf: mobile personal center responsive layout for dialogs/cards/usage records
  • Perf: mobile chat floating button rounded corner clipping (InkWell + StadiumBorder)
  • Perf: mobile frontend update FAB avoids input area
  • Perf: macOS settings scroll no longer bounces (ClampingScrollPhysics)
  • Perf: tool card header text contrast improvement for dark theme readability
  • Perf: frontend update check interval reduced from 6h to 10min
  • Perf: reduce helix-agent RSS memory to 300MiB (GOMEMLIMIT + GODEBUG)
  • Perf: remove redundant Obx wrapper in backend log list, fix white screen on page switch
  • Perf: SnackBar with action auto-dismisses on desktop after 8s
  • Perf: remove dead suppressThinking field and orphaned helper
  • Fix: macOS Flutter upgrade causing missing window close button symbol
  • Fix: standalone GiteaAgentPage nested Scaffold gesture blocking
  • Fix: missing onFocusReceived method for new Flutter TextInputClient
  • Fix: binding dialog bottom overflow, Agent config URL parsing and auth
  • Fix: duplicate output from multi-controller consuming same session stream
  • Fix: Holdback watchdog triggering completion after manual cancel
  • Migrate: Android Gradle config to built-in Kotlin DSL

Helix-agent

  • Feat: workspace-scoped learned skills with promote-to-global support
  • Feat: ShellGuard — lightweight LLM Shell command safety check
  • Feat: Gitea Agent MCP tool set — 10 collaboration tools, Issue/PR comments as collaboration channels
  • Feat: Gitea Agent full refactor — reuse aiagent session framework, remove custom LLM engine
  • Feat: Gitea Agent workspace binding and auth (X-Agent-UUID/X-Agent-Token)
  • Feat: built-in Office MCP tools (xlsx/docx read/write)
  • Feat: retry-from-interruption backend flow
  • Feat: SSE WebSocket confirmed message retry after disconnect
  • Fix: Dream lock mtime responsibility split — prevent 24h gate interference from lock file mtime
  • Fix: cua-driver daemon kind/payload wrapper format causing blank screenshots
  • Fix: cua-driver click param disambiguation — strip element_index when x/y also present
  • Fix: ShellGuard does not stall safe commands
  • Fix: stop retries after request cancellation
  • Fix: allow cancellation while tools are running
  • Perf: gpt-5.5 context window adjusted to 270K
  • Perf: PebbleDB block cache reduced from default 8MiB to 2MiB
  • Perf: context cache cap clamped to model window

Repository commits

  • agentui: 06d6c72
  • aiagent: d3bcc69
  • helix-vm: ed7d186

v1.3.0 · 2026-05-17

Summary

  • Helix: session full-text search, Report Bug with one-click log upload, ASR auto-send preference, Manager split-button for new session, comprehensive UX overhaul and performance optimization
  • Helix-agent: cache strategy adjustments (global token cap 300K / DeepSeek 500K), anti-polling guidance in tool descriptions

Helix

  • Feat: session full-text search (Cmd+F), startup skeleton screen optimization
  • Feat: Report Bug dialog that collects frontend/backend/session logs and uploads as a compressed archive
  • Feat: ASR auto-send preference setting
  • Feat: split-button for Manager new session (one-click create, right arrow to switch type)
  • Feat: responsive SelectorSettingsDialog (<600px uses ChoiceChip top bar instead of sidebar)
  • Feat: tunnel management entry moved from PersonalCenter to ServerCard expansion area
  • Fix: restore truncated _FloatingButtonGroup class
  • Fix: tool card header text contrast with fidelity scheme variant
  • Fix: _SideTabHandle parameter mismatch
  • Fix: chat connection status stuck on 'connecting' for new sessions
  • Fix: null safety in BugReportService._attachSessionExport
  • Perf: frontend update checker polling interval 6h→10min
  • Perf: bump Flutter dependencies to latest resolvable versions
  • Perf: comprehensive UX overhaul (layout/navigation/interaction optimization)
  • Remove: layout preset switcher

Helix-agent

  • Feat: add anti-polling guidance to background_task_output and run_subagent tool descriptions
  • Perf: global token cap raised from 200K to 300K
  • Perf: DeepSeek cache strategy adjustment (N=200, token cap=500K)

Repository commits

  • agentui: 993ff82
  • aiagent: bcac871
  • helix-vm: 8b1ffa2

v1.2.9 · 2026-05-16

Summary

  • Helix: cloud tunnel mode optimization, multi-window back button fix, session message cache refresh on incremental update, precise server binding removal by nodeId

Helix

  • Fix: don't force switch tunnel mode when cloud tunnel status is normal
  • Fix: multi-window back button routing to the wrong window
  • Fix: update internal message cache after incremental session list refresh
  • Fix: removeServerBinding removes binding by nodeId precisely to avoid accidental deletion

Helix-agent

  • No changes

Repository commits

  • agentui: 2c0c3ee
  • aiagent: f8f59e3
  • helix-vm: 8b1ffa2

v1.2.8 · 2026-05-15

Summary

  • Helix: Skills promoted to top-level tool tab, tunnel management page, performance optimizations, unified agent deletion with cloud sync, tunnel gateway info sync, synced workspace ID resolution, debug logging
  • Helix-agent: Tunnel start/stop API endpoints, streaming response rescue improvements, unified empty response rejection, synced workspace ID support in GetWorkspace

Helix

  • Feat: promote Skills to a top-level tab in the tool panel, alongside Prompts and MCP
  • Feat: add tunnel management page for viewing/creating/deleting/testing SSH tunnels
  • Feat: unified agent delete with cloud sync propagation
  • Feat: sync tunnel gateway info (gateway_node_id/subdomain_url) to local binding and cloud
  • Feat: add debug logging for session list request chain
  • Perf: cache model grouping in toolbar and isolate repaint scope
  • Perf: cache grouped items in Manager Board to reduce rebuild cost
  • Perf: move server list refresh out of build in workspace selector
  • Fix: selfhost binding LWW fields and soft delete handling
  • Fix: stop auto-creating duplicate Android POC workspace on every app restart
  • Fix: skip Events WebSocket for unresolved synced workspace IDs
  • Fix: skip loadSessions for synced workspace IDs containing '/'
  • Fix: notify ChatController and PTY controller after resolving synced workspace ID
  • Fix: ChatController resolves tunnel URL from syncedServers
  • Fix: fallback effectiveServerUrl/requestServerUrl to syncedServers tunnel URL
  • Fix: use nodeId as primary key for isServerRemovedLocally
  • Fix: clean up workspace records and syncedServer entries on agent deletion
  • Fix: add X-Aiagent-Credential header for non-cloud/tunnel connections
  • Fix: guard nullable requestServerUrl isNotEmpty access
  • Fix (Windows): guard WindowScope.maybeIsActivatedOf with try-catch

Helix-agent

  • Feat: add tunnel start/stop API endpoints called by the frontend tunnel management page
  • Fix: unify empty response rejection logic for both Anthropic and Responses APIs
  • Fix: Anthropic streaming partial response rescue — keep content when partial data exists
  • Fix: filter incomplete tool_use when rescuing partial responses
  • Fix: determine tool call completion by toolInputs liveness
  • Fix: append empty user prompt when input ends with function_call_output
  • Fix: narrow empty response check to allow reasoning-only to pass through
  • Fix: support synced: workspace ID format in GetWorkspace

Repository commits

  • agentui: 3865a5f
  • aiagent: f8f59e3
  • helix-vm: 8b1ffa2

v1.2.7 · 2026-05-14

Summary

  • Helix: restore NSWindow level when cua-driver deactivates the app
  • Helix-agent: telemetry improvements (ServerWaitDuration, unified log format), fix cua-driver MCP auto-enable for new sessions, per-session skill snapshot, context cache recalculation on model switch, network benchmark tool

Helix

  • Fix: add NSWindow level self-heal to restore window level when cua-driver AXMain side effect lowers it

Helix-agent

  • Feat: add network latency benchmark tool for provider connectivity testing
  • Feat: add ServerWaitDuration (Wait=) telemetry field to explain gap between first token and total duration
  • Feat: add Upload= body upload timing to telemetry logs
  • Feat: add cache hit percentage to adapter usage log
  • Refactor: unify all 3 provider usage log formats and add Model/URL fields
  • Fix: make cua-driver MCP auto-enable for new sessions so tools are available immediately
  • Fix: change skill list from global shared cache to per-session immutable snapshot
  • Fix: recalculate context cache config when model switch changes cache cost type (#3)
  • Fix: restore accidentally deleted structured log lines ([OpenAI] model=..., [Token Usage] In:...)
  • Fix: cap semantic empty retries and preserve model defaults
  • Fix: use blank synthetic reasoning placeholder to prevent rendering issues
  • Fix: skip auto-background for any command containing 'sleep'

Repository commits

  • agentui: cbcc3df
  • aiagent: 0ee0d35
  • helix-vm: 8b1ffa2

v1.2.6 · 2026-05-13

Summary

  • Helix: bundle cuadriver-mcp-proxy in macOS app bundle, increase context cache threshold max, change default effort to max
  • Helix-agent: no user-facing changes

Helix

  • Fix: bundle cuadriver-mcp-proxy in macOS app Resources so CUA MCP tool is available immediately after install
  • Feat: raise context cache threshold configurable max from 200 to 500
  • Feat: change default LLM effort from medium to max for higher quality responses

Repository commits

  • agentui: 487f069
  • aiagent: a558138
  • helix-vm: 8b1ffa2

v1.2.4 · 2026-05-11

Summary

  • Helix: No changes
  • Helix-agent: Telemetry reporting no longer requires selfhost credentials; any node with a NodeID can now report

Helix-agent

  • Improved: Node telemetry removes Credential requirement — heartbeat and usage data can be reported with NodeID alone, even before selfhost pairing is completed

Repository commits

  • agentui: 431e72e
  • aiagent: dc566de
  • helix-vm: 8b1ffa2

v1.2.3 · 2026-05-11

Summary

  • Helix: Fix multi-host workspace identity matching logic; improve local machine workspace display; fix logged-out personal center and FAB overlap
  • Helix-agent: Fix telemetry reporting to connect directly to new-api, bypassing the relay gateway

Helix

  • Fixed: Workspace selector now matches existing machines by (url, nodeId) pair to avoid multi-host identity confusion
  • Fixed: Local machine workspace is now visible to new unauthenticated users; filter counts added
  • Fixed: Restore credential for localOnly bindings when cloud account is logged in
  • Fixed: Personal center page displays correctly when logged out
  • Fixed: Update FAB no longer overlaps with the scroll button

Helix-agent

  • Fixed: Node telemetry heartbeat now reports directly to new-api, bypassing the tunnel gateway

Repository commits

  • agentui: 431e72e
  • aiagent: 28e9d20

v1.2.2 · 2026-05-11

Summary

  • Helix: Add auto-update check with download FAB; hide VM manager on mobile; improve multi-host workspace selector identity; fix file-sync target server binding
  • Helix-agent: Expose selfhost NodeID header and revoke cloud binding on local delete; add snag remote lite mode; fix proxy-aware SSH dial with parallel probes; add node heartbeat telemetry

Helix

  • Added: Auto-check frontend updates and surface a download floating action button (FAB) when a newer version is available
  • Added: Hide VM manager on mobile and add Android self-update flow
  • Added: Workspace selector verifies NodeID when probing server latency to avoid multi-host identity confusion
  • Fixed: Bind file sync to the correct target server
  • Fixed: Update default Helix-vm template catalog URL

Helix-agent

  • Added: Selfhost API exposes NodeID response header; automatically revokes cloud binding when a local node is deleted
  • Added: Snag remote lite mode and standalone snagserver
  • Added: Node heartbeat self-report and per-provider token usage telemetry
  • Fixed: Skip truncation for longterm_chat tool results to prevent over-trimming in long sessions
  • Fixed: Proxy-aware SSH dial, faster keepalive recovery, and parallel list probe

Repository commits

  • agentui: 64ba319
  • aiagent: 618ab54
  • helix-vm: 8b1ffa2

v1.2.1 · 2026-05-05

Summary

  • Helix: show context size in preview header; stabilize streaming chat updates
  • Helix-agent: prompt layering architecture (P1-P5), Brainstorm Manager, context cache tuning, and various fixes

Helix

  • Show total context size in chat preview header
  • Stabilize streaming chat updates

Helix-agent

  • Introduce prompt layering architecture P1-P5: Capability registry, OutputStyle layer, SystemPrompt Block with Section registry and cache scoping
  • Implement full Brainstorm Manager system prompt with META+R0-R7 structure and read-only tool enforcement
  • Raise context cache default threshold to 100
  • Expose context character and byte counts in preview
  • Preserve custom prompt id across session copies
  • Provide built-in assistant lite tooling guidance
  • Add custom prompt fine-grained switches for skills, memory, and tools
  • Propagate worktree policy to subagents and serena sessions
  • Split runtime boundary and decouple serena capability from tooling base
  • Various fixes and test coverage improvements

Repository commits

  • agentui: 9c13cb83da3daf3595412fca37e5908ad686de9d
  • aiagent: b668f0496886b27ec4d5279a6164691a723e0c26

v1.2.0 · 2026-05-03

Summary

  • Helix adds built-in image generation tools (generate_image, edit_image), a gamification UI with growth progress and level badges, editor external-file change detection, brainstorm manager mode, and file-sync directory download with transfer cancel.
  • Helix-agent adds generate_image and edit_image MCP tools with disk-backed image persistence, CRG built-in code graph skill, MiMo model defaults, and stabilizes MCP ordering for better cache hits.

Helix

  • Added: Built-in image generation tool cards (generate_image, edit_image) render image previews with auth-aware Image.network and support saving/downloading generated images.
  • Added: Gamification UI showing user growth progress, experience history, and level table with avatar-level badge.
  • Added: Brainstorm manager mode UI for collaborative brainstorming sessions.
  • Added: Prompt split button for new chat sessions; prompt selector locked for existing sessions.
  • Added: Editor detects external file modifications and refreshes tabs when disk changes are detected.
  • Added: File-sync supports directory download with recursive listing, byte-level progress bars (1s/1MB throttle), and transfer cancellation.
  • Added: MiMo provider preset.
  • Added: Helix-vmd auto-starts on app launch if previously used; graceful shutdown via /api/vms/stop-all.
  • Added: Centralized external-change poll interval constant; saveTab failures surfaced via snackbar.
  • Fixed: Duplicate longterm_tool_call and longterm_tool_result event rendering when child session dialog is open.
  • Fixed: Generated image rendering in chat messages.
  • Fixed: Sub-agent dialog uses always-on HTTP snapshot + length-baseline merge in registerLiveSession; saHandleCreated made idempotent.
  • Fixed: Editor right-click menu now shows Cut/Copy/Paste/Select All without overlapping with CodeForge built-in menu.
  • Fixed: VM port-forward edit tooltip and silent short-circuit behavior.
  • Fixed: VM state parsed from runtime.state instead of top-level field.

Helix-agent

  • Added: generate_image built-in MCP tool that calls OpenAI /v1/images/generations endpoint, persists generated images to disk, and serves them via /static/imagegen.
  • Added: edit_image MCP tool for iterative image editing with mask support.
  • Added: CRG (Code Review Graph) as built-in global MCP service with crg skill for repository-level architecture analysis.
  • Added: MiMo model defaults in inferModelConfig.
  • Added: /fs/stat endpoint with mod_time field; WriteFile records modification time for external-change detection.
  • Added: Brainstorm manager mode backend.
  • Fixed: Parallel Anthropic tool_use stream events are now routed by event.Index to prevent interleaved content corruption.
  • Fixed: Anthropic tool image handling and base64 URL guard.
  • Fixed: Image generation timeout extended; UI images split from LLM images to prevent 4xx in next LLM turn.
  • Fixed: Image-only models hidden from chat selector (tool unaffected).
  • Fixed: screenshot_url returns ImageContent instead of TextContent.
  • Improved: Skills and MCP tool ordering stabilized for better context cache hit rate.
  • Improved: Prompts locked after session creation for consistent cache keys.

Repository commits

  • agentui: 9a80a5d
  • aiagent: a024962

v1.1.6 · 2026-04-29

Summary

  • Helix fixes duplicate sub-agent tool-call rendering when a child session dialog is open, adds a test for the guard, and improves the QEMU data-directory setup on Windows.
  • Helix-agent adds read_file tool-name alias for LLM compatibility, improves OpenAI streaming deduplication, and synthesizes missing reasoning tokens for tool calls.

Helix

  • Fixed: Mirrored longterm_tool_call and longterm_tool_result events from the manager session are now suppressed while the child session's own WebSocket stream is connected, preventing duplicate tool step rendering in the sub-session dialog.
  • Fixed: QEMU data-directory startup notifier is now mirrored in the helix-vmd web stub so non-IO builds surface directory errors correctly on Windows.
  • Fixed: Data-directory child directories are pre-created before spawning the managed process; path separators are trimmed and unwritable paths surface a clear error.
  • Improved: QEMU setup guide surfaces optionalfeatures.exe launch errors so users see actionable feedback during WHPX acceleration setup.

Helix-agent

  • Added: read_file is now accepted as an alias for the canonical read-file tool so LLMs that call the underscored form do not get a "tool not found" error.
  • Fixed: OpenAI-compatible streaming deduplicates equivalent consecutive tool calls to prevent phantom repeated steps.
  • Fixed: Missing reasoning tokens are synthesized for tool-call messages to avoid malformed continuation requests to reasoning-capable models.
  • Improved: Thinking stream shape and request message diagnostics are logged at 400 errors for easier debugging.

Repository commits

  • agentui: 7f2264e
  • aiagent: 32475b6

v1.1.5 · 2026-04-27

Summary

  • Helix adds a first-run language selection dialog, a local VM manager tab, and an "awaiting input" session badge; fixes stream ownership, longterm session replay, and managed backend PATH handling.
  • Helix-agent adds DeepSeek V4 reasoning effort and thinking toggle support, tracks waitingForUser state for blocked sessions, and fixes context window and orphan tool message handling.

Helix

  • Added: First-run one-time language selection dialog shown at startup before safety and data-directory prompts.
  • Added: Local VM manager tab in the desktop app for monitoring and managing local VMs.
  • Added: Session list now shows an "awaiting input" badge for sessions blocked on ask_user.
  • Fixed: Managed backend shell environment PATH separators are now preserved correctly on macOS launch.
  • Fixed: Duplicate longterm session stream mirroring prevented when multiple controllers attach.
  • Fixed: WebSocket stream consumer ownership is restricted to the correct session owner.
  • Fixed: Longterm child session progress is replayed correctly on reconnect.
  • Fixed: Sessions stop attempting to reconnect when the assigned model is unavailable.
  • Fixed: Multi-window compression state is updated independently per window.

Helix-agent

  • Added: DeepSeek V4 series models now support reasoning_effort and explicit thinking on/off toggle.
  • Added: waitingForUser state is tracked and broadcast to clients when a session is blocked on ask_user.
  • Fixed: DeepSeek V4 thinking continuation and context window limits handled correctly.
  • Fixed: OpenAI orphan tool messages cleaned up to prevent malformed continuation requests.

Helix VM (bundled in macOS desktop)

  • Added: Automatic bootstrap-secret injection via kernel cmdline for managed VM workspaces.
  • Fixed: registryMu re-entry deadlock when storing a bootstrap grant during VM creation.
  • Fixed: VM detail panel stays visible when a sidebar search narrows the VM list.
  • Fixed: VM selection no longer stuck due to React transition starvation.
  • Fixed: qemu-img is now resolved from the QEMU sibling path on macOS GUI launch.

Repository commits

  • agentui: 5b2744a
  • aiagent: 6819700

v1.1.4 · 2026-04-26

Summary

  • Helix tightens multi-window stream ownership and clears stale chat streaming indicators on disconnect.
  • Helix-agent adds built-in GPT-5.5 and Claude Opus 4.7 model defaults and raises shell command timeout defaults.

Helix

  • Fixed: Frontend now enforces one WebSocket per session, preventing duplicate stream consumption when multiple controllers attach.
  • Fixed: Per-window workspace switching is independent in multi-window setups; the focused window owns the global state and other windows no longer get clobbered.
  • Fixed: Stream consumer ownership tokens stay consistent across claim, should-consume checks, and release, so the real owner is no longer blocked.
  • Fixed: Stale chat streaming indicators are cleared correctly after disconnect or session end.
  • Fixed: Markdown inline style inheritance normalized in chat rendering.

Helix-agent

  • Added: Built-in defaults for GPT-5.5 and Claude Opus 4.7 models.
  • Improved: Default shell command timeouts and tool-description guidance increased to better match real long-running build/test workflows.

Repository commits

  • agentui: 1d097ea
  • aiagent: 457cdb7

v1.1.3 · 2026-04-24

Summary

  • Helix automatically pairs managed VM workspaces without requiring a pairing code, and avoids spurious cross-mode session stream pre-fetching.
  • Helix-agent fixes streamed output replay duplication and handles embedded 402 payment-required errors inside otherwise-successful provider responses.

Helix

  • Added: Managed VM workspaces now auto bootstrap-claim on launch, skipping the manual pairing-code step.
  • Fixed: Cross-mode session stream pre-fetch is avoided, preventing ghost connections when switching chat modes.

Helix-agent

  • Fixed: Streamed output replay no longer duplicates content on reconnect.
  • Fixed: Embedded 402 errors inside successful HTTP responses are now detected and handled as retriable failures.

Repository commits

  • agentui: 17cf6c9
  • aiagent: 8234641

v1.1.2 · 2026-04-23

Summary

  • Helix ships an end-to-end local VM workspace flow with a template marketplace, desktop thinking-effort controls, a composer screenshot entry, friend-site key import, and a range of desktop stability and installer fixes.
  • Helix-agent adds per-model speed test and thinking-effort persistence APIs, routes WeChat clawbot conversations to multiple internal sessions, respects the configured data directory for runtime paths, and fixes sub-agent request context on OpenAI-compatible providers.

Helix

  • Added: VM template marketplace dialog with synced/upgrade-available status and progress feedback for in-flight installs.
  • Added: Local VM workspace creation flow — CPU/memory/disk fields, auto-raised disk floor, default aiagent port forward (guest 8081), auto-filled host ports for business forwards, and full i18n for VM dialogs.
  • Added: Desktop thinking-mode interactive popup with effort switching and persistence, plus a desktop composer screenshot entry.
  • Added: Friend/other-site account import — login, nested key list parsing, default URL preset, Anthropic provider inference, and claude-opus-4-7 preset.
  • Added: Per-model speed test action in provider configuration.
  • Improved: Add-workspace flow now aligns local and remote VM branches, requires VM configuration before managed create, and hides unavailable workspace entry options.
  • Improved: Shared runtime parent directory for local and VM storage, bundled helix-vmd lifecycle management, and macOS helix-vmd launched with the login shell PATH.
  • Fixed: VM workspace dialog drops the mount field, fixes action-button overlap, waits for guest aiagent readiness, and extends the startVm client timeout.
  • Fixed: ask_user custom note input now submits the free-text value by default.
  • Fixed: macOS screenshot reliability via direct /usr/sbin/screencapture, avoidance of false-negative permission preflight, and a corrected Runner.xcodeproj bundling phase.
  • Fixed: Settings dialog right-panel controller is now registered for the scoped dialog, preventing stale state across reopen.
  • Fixed: Provider add dialog no longer snackbars on a deactivated context after a successful add.
  • Fixed: Concise-mode toggle is now clickable on the desktop composer bar; thinking popup switch tap, effort rollback, and popup placement corrected.
  • Fixed: Marketplace progress bar is hidden for already-installed templates; helix-vmd receives the default template-catalog URL; helix-vmd can start without a local bundle directory.
  • Changed: Windows installer metadata refreshed and autostart registry entry removed to reduce SmartScreen/Defender friction.

Helix-agent

  • Added: Per-model speed test API for provider configuration.
  • Added: Thinking API now persists effort level; empty payloads on the thinking/effort update endpoint are rejected.
  • Added: WeChat clawbot multi-session conversations routed from a single external chat window to multiple internal AI sessions.
  • Improved: ask_user defaults free-text input to enabled.
  • Improved: Runtime paths and default skill paths now respect the configured data directory instead of hardcoded ~/.aiagent locations.
  • Fixed: Sub-agents on OpenAI-compatible providers now always receive a non-nil request context.
  • Fixed: Invalid Chromium auto-download on linux/arm64 is skipped instead of failing snag bootstrap.

Repository commits

  • agentui: d570563
  • aiagent: 03a2a82

v1.1.1 · 2026-04-20

Summary

  • Helix strengthens chat and workspace flow with manual file sync, denser interaction layouts, more accurate todo and ask-user rendering, safer multi-session WebSocket handling, smoother workspace selector behavior, and final release version updates.
  • Helix-agent adds manual file sync APIs, improves skill review accuracy and per-session accounting, reduces noisy background progress prompting, stabilizes todo and holdback lifecycle handling, fixes merged system reminder projection state, and includes the latest prompt context updates.

Helix

  • Added: Manual file sync page with drag-and-drop transfer support and local folder creation.
  • Improved: Chat density, workspace selector polish, and overall message projection refresh behavior during incremental streaming.
  • Fixed: Session todo state now stays synchronized, ask_user selection results render correctly, and duplicate streaming is blocked across competing WebSocket consumers.
  • Fixed: File sync requests now include the required agent auth endpoints, and stale WebSocket session connections are cleaned up more reliably.
  • Fixed: Workspace selector back navigation and recent-workspace filtering behave more predictably.

Helix-agent

  • Added: Manual file sync backend endpoints for local/remote transfer workflows.
  • Improved: Skill review scoring now uses incremental windows, keeps accumulation per session, raises the default max history window, and separates learned-skill handling more cleanly.
  • Improved: Background progress prompting and todo reminder wording are reduced to lower noisy follow-up polling.
  • Fixed: Session todo lifecycle is more stable, manual cancel correctly releases sub-agent holdback, and longterm sessions receive cancel follow-up updates.
  • Fixed: Projection indexes remain correct when merged system reminders are inserted into session history.
  • Improved: Skills context is now moved into user system reminders for cleaner prompt composition.

Repository commits

  • agentui: bd42d0e
  • aiagent: 9212c57

v1.1.0 · 2026-04-20

Summary

  • Helix strengthens chat and workspace flow with manual file sync, denser interaction layouts, more accurate todo and ask-user rendering, safer multi-session WebSocket handling, and smoother workspace selector behavior.
  • Helix-agent adds manual file sync APIs, improves skill review accuracy and per-session accounting, reduces noisy background progress prompting, stabilizes todo and holdback lifecycle handling, and fixes merged system reminder projection state.

Helix

  • Added: Manual file sync page with drag-and-drop transfer support and local folder creation.
  • Improved: Chat density, workspace selector polish, and overall message projection refresh behavior during incremental streaming.
  • Fixed: Session todo state now stays synchronized, ask_user selection results render correctly, and duplicate streaming is blocked across competing WebSocket consumers.
  • Fixed: File sync requests now include the required agent auth endpoints, and stale WebSocket session connections are cleaned up more reliably.
  • Fixed: Workspace selector back navigation and recent-workspace filtering behave more predictably.

Helix-agent

  • Added: Manual file sync backend endpoints for local/remote transfer workflows.
  • Improved: Skill review scoring now uses incremental windows, keeps accumulation per session, raises the default max history window, and separates learned-skill handling more cleanly.
  • Improved: Background progress prompting and todo reminder wording are reduced to lower noisy follow-up polling.
  • Fixed: Session todo lifecycle is more stable, manual cancel correctly releases sub-agent holdback, and longterm sessions receive cancel follow-up updates.
  • Fixed: Projection indexes remain correct when merged system reminders are inserted into session history.

Repository commits

  • agentui: bd42d0e
  • aiagent: 3c9dabb

v1.0.59 · 2026-04-18

Summary

  • Helix expands the skills workspace with learned-skill management, review history and settings, improves skill review status visibility, fixes execute_shell card layout on narrow screens, and hardens holdback state restoration.
  • Helix-agent adds built-in skill installation and configurable background skill review, improves local VM console and template support, strengthens skill review concurrency handling, and fixes holdback state reporting for reconnect flows.

v1.0.59 · 2026-04-18

Summary

  • Helix expands the skills workspace with learned-skill management, review history and settings, improves skill review status visibility, fixes execute_shell card layout on narrow screens, and hardens holdback state restoration.
  • Helix-agent adds built-in skill installation and configurable background skill review, improves local VM console and template support, strengthens skill review concurrency handling, and fixes holdback state reporting for reconnect flows.

Helix

  • Added: Learned Skills tab with filtering affordances, delete actions, and review badges in the Skills page.
  • Added: Skill review settings panel, review history entry point, and richer skill review status card feedback.
  • Fixed: execute_shell tool cards now keep a cleaner layout on narrow chat widths.
  • Fixed: Skill review history now resolves workspace context more reliably.
  • Fixed: Holdback state is preserved when Watchdog, TaskCompleted, and Connected events race during sub-agent completion.

Helix-agent

  • Added: Built-in skill installer support for shipping curated skills directly from the agent runtime.
  • Added: Configurable background skill review with improved scoring, gating, and task-type filtering.
  • Added: Local VM console redesign, vmhostd sandbox shell UI, multi-VM templates, and runtime fixes for appliance workflows.
  • Fixed: Skill review counters and per-session locks now remain correct under concurrent execution.
  • Fixed: Holdback REST and reconnect state now report pending sub-agents consistently to clients.
  • Added: Anthropic requests now include the context-1m-2025-08-07 beta flag where required.

Repository commits

  • agentui: c829ee2
  • aiagent: 4a0e8c9

v1.0.58 · 2026-04-17

Summary

  • Helix adds a multi-channel notification system with a rich configuration UI and test-send support, an AskUser interactive card, sub-agent type badges, a unified ProgressCard with todos, tool result priority rendering, and five tool-call UI improvements.
  • Helix-agent adds multi-channel notification push, a todo_write tool, the ask_user interactive tool, a sub-agent holdback mechanism, agent_type routing for run_subagent, explore/plan model config, and Shell Sprint1 reliability upgrades.

Helix

  • Added: Notification channel configuration UI supporting Feishu, DingTalk, WeCom, Telegram, OneBot, and Custom HTTP, with a test-send button.
  • Added: AskUserCard widget — displays an interactive confirmation card when the agent invokes ask_user.
  • Added: Sub-agent type badge (icon + label) shown on sub-agent tool cards and redesigned for clarity.
  • Added: Unified ProgressCard replaces PhaseCard + LivePanel; now displays real-time todo_write task list.
  • Added: Tool result rendering differentiation — P0 (critical), P1 (important), and P2 (verbose) results are styled differently.
  • Added: Five tool-call UI improvements: differentiated icons, parameter summaries, failure state display, animations, and per-call timers.
  • Added: execute_shell summary now extracts the leading # intent comment as the card title.
  • Added: Explore model configuration UI in workspace settings.
  • Fixed: AskUserCard hover/cursor style and answered-card content rendering.
  • Fixed: Manager WaitingStatusBar compacted to a single line to reduce visual noise.
  • Fixed: /api/notify-channels added to agent credential whitelist.

Helix-agent

  • Added: Multi-channel notification push supporting Feishu, DingTalk, WeCom, Telegram, OneBot, and Custom HTTP webhooks.
  • Added: POST /api/notify-channels/test endpoint for sending test notifications.
  • Added: todo_write MCP tool — agents can maintain a real-time task checklist visible in the UI.
  • Added: ask_user interactive tool — pauses agent execution and waits for user confirmation.
  • Added: Sub-agent holdback mechanism — agent stays in processing state until all background sub-agents complete.
  • Added: agent_type parameter for run_subagent (general / explore / plan / verification) with independent prompts and tool filtering.
  • Added: Explore/plan model config — workspace settings now support a separate lightweight model for explore and plan sub-agents.
  • Added: execute_shell schema updated to guide agents to write intent comments on the first line.
  • Added: Shell Sprint1 reliability upgrades — output truncation, timeout improvements, and size watchdog.
  • Added: Alpine appliance build pipeline for local VM (direct-kernel boot).
  • Fixed: Notification WaitGroup — prevents context canceled when multiple channels run concurrently.
  • Fixed: Anthropic CC fingerprint algorithm aligned with official CC 2.1.111 for improved cache hit rate.
  • Fixed: connected WebSocket message now carries has_pending_subagents so reconnected clients restore holdback state.
  • Fixed: claudecli dynamic model lookup no longer returns nil after model list refresh.
  • Refactored: System prompt split into 5 focused files; toolingBasePrompt duplication eliminated.

Repository commits

  • agentui: 8bb7545
  • aiagent: 3a2c4ab

v1.0.57 · 2026-04-17

Summary

  • Helix upgrades global interaction animations with the cue library, fixes PTY WebSocket heartbeat, resolves workspace selector navigation, and improves the macOS updater and Windows URL handling.
  • Helix-agent stabilizes PTY SSH reliability, fixes context-cache fingerprint consistency, simplifies message-level cache checkpoints, and adds initial local VM (aarch64 UEFI + DHCP) infrastructure.

Helix

  • Added: Introduced cue animation library for polished, high-quality interaction animations across the app.
  • Fixed: PTY client now sends WebSocket heartbeat Ping to prevent idle disconnection by Nginx/load-balancer.
  • Fixed: Workspace selector Chat button now correctly navigates into workspaces created after app startup (signature includes localId).
  • Fixed: Thinking block no longer renders duplicate content during streaming display.
  • Fixed: macOS .pkg updater now waits for the old process to exit before launching the installer.
  • Fixed: Opening URLs on Windows now uses url_launcher to prevent & characters from being truncated by cmd.exe.

Helix-agent

  • Added: Local VM support — aarch64 UEFI firmware auto-injection and guest systemd-networkd DHCP configuration.
  • Fixed: Windows PTY SSH disconnection and getClient() nil pointer panic resolved.
  • Fixed: First-round message cache fingerprint inconsistency causing low cache hit rate.
  • Refactored: Simplified Anthropic message-level cache checkpoint to a single trailing breakpoint.
  • Fixed: Corrected thinking signature validation logic — removed erroneous claude# prefix check.

Repository commits

  • agentui: 9c38989
  • aiagent: 3683375

v1.0.56 · 2026-04-16

Summary

  • Helix fixes model lookup to automatically refresh the model list when a model is not found, and resolves Lite workspace initialization issues.
  • Helix-agent adds a cross-platform GET /api/workspaces/lite endpoint and removes unnecessary diff file writing behavior.

Helix

  • Fixed: When a model is not found, the app now automatically refreshes the model list before showing an error to the user.
  • Fixed: Added isEmpty guard in inner model check to prevent false error prompts when the model list is empty.
  • Fixed: Lite workspace now uses getLiteWorkspace() instead of createWorkspace('/virtual/lite') for correct initialization.

Helix-agent

  • Added: GET /api/workspaces/lite endpoint for cross-platform Lite workspace support.
  • Changed: Removed ~/.aiagent/diff/ file writing behavior to reduce unnecessary disk I/O.

Repository commits

  • agentui: 10faaee
  • aiagent: bf36121

v1.0.55 · 2026-04-16

Summary

  • Helix adds a Debug Proxy settings panel (proxycat integration), a new Lite Chat mode with optimistic rendering, file drag-and-drop attachments (text + PDF), a custom provider wizard, and numerous bug fixes for multi-window drag, tab reorder, and attachment lifecycle.
  • Helix-agent adds an embedded debug proxy API with cache-break detection, file attachment end-to-end pipeline (manager → longtermchat → subagent), thinking effort level wiring, mcp-go upgrade, and several context-cache and Anthropic 400 stability fixes.

Helix

  • Added: Debug Proxy settings panel — enable/disable proxycat, view Web UI URL directly from the settings page.
  • Added: Lite Chat mode with optimistic rendering — eliminates loading delay when entering a chat session.
  • Added: File drag-and-drop attachments supporting text files and PDFs; attachment chips persist across session switches.
  • Added: File editor / file tree right-click context menu to quote files into the chat input.
  • Added: Custom provider wizard (Step 2) with mandatory provider ID and display name fields.
  • Fixed: Multi-window file drag — native window ID carried in patched desktop_drop to prevent cross-window event leaks.
  • Fixed: Tab reorder in unified workspace now uses LongPressDraggable with scroll-offset correction and ID-based stale-index safety.
  • Fixed: WorkspaceMenuBar setState during build no longer throws.
  • Fixed: Inactive IndexedStack slots suppress drag events via Visibility.of.
  • Fixed: macOS drop target — prepareForDragOperation implemented; FlutterView lookup uses retry with fallback.
  • Fixed: Lite Chat — server URL uses local initial address, unaffected by professional mode connections.
  • Fixed: Lite workspace filters virtual workspaces and optimizes toolbar layout.
  • Fixed: ModernSessionList Obx improper-use error when hideTabs=true.

Helix-agent

  • Added: Embedded debug proxy API (/api/settings/debug-proxy) with cache-break detection (proxycat integration).
  • Added: File attachment end-to-end pipeline — attachments forwarded across manager → longtermchat → subagent chain.
  • Added: FileAttachment snippet type support.
  • Added: usage events now carry context_window field for accurate subagent context percentage display.
  • Added: Lite workspace auto-creation and connection; lite mode restricts shell/subagent/tmux tools.
  • Changed: mcp-go upgraded from v0.32.0 to v0.48.0.
  • Changed: Thinking effort level wired dynamically through output_config.effort.
  • Fixed: Context cache — replaced map[string]interface{} with typed structs for deterministic JSON key ordering.
  • Fixed: AutoTriggerContextCacheIfNeeded refactored to accept usage parameter, aligned with TryAutoCompress.
  • Fixed: sendWithCacheHandling now immediately updates session.TotalTokens after each round, fixing totalTokens=0 on Anthropic provider.
  • Fixed: PDF attachments use input_file block instead of placeholder text (Responses API).
  • Fixed: saveMessages uses convertLLMMessagesToOpenAI to prevent attachment data loss on persistence.
  • Fixed: Anthropic 400 — trailing assistant message now defended at three layers; infinite retry loop eliminated.
  • Fixed: CI workflow now checkouts proxycat from the agent mono-repo via sparse-checkout, fixing build failures introduced by the local replace directive.

Repository commits

  • agentui: 0a5d226
  • aiagent: 4c9e949

v1.0.54 · 2026-04-14

Summary

  • Helix introduces a unified workspace layout with file tree and tabbed editing, enhanced split pane with context menu and cross-pane drag, workspace tab i18n, and fixes for longterm SubAgentMeta modelId display.
  • Helix-agent fixes image forwarding loss across manager rounds and prevents corrupted Anthropic thinking signatures from causing 400 errors.

Helix

  • Added: Unified workspace layout with integrated FileTree panel and tabbed code/file editing experience.
  • Added: Split pane enhanced with right-click context menu and cross-pane drag-and-drop support.
  • Added: Close-right-tabs menu action; tab reorder fix; tool panel defaults to collapsed on open.
  • Added: i18n translations for workspace tab context menu items.
  • Fixed: ensureSubAgentMeta double dedup guard (in-flight set + no-model retry prevention) to avoid redundant fetches.
  • Fixed: Cleanup now synchronously clears the ensureMeta in-flight set to prevent stale entries.
  • Fixed: Longterm SubAgentMeta modelId missing caused incorrect context limit display — full fix applied.

Helix-agent

  • Fixed: Manager mode cross-round image forwarding loss — images attached in earlier rounds are now correctly forwarded to subsequent rounds.
  • Fixed: Corrupted Anthropic thinking block signature no longer causes 400 errors; defensive handling strips invalid blocks before retry.

Repository commits

  • agentui: 36d1e97d2bb7bfac5c87dd5ac7841f2c2297afaf
  • aiagent: 04f3f543d5449e1df720f5bdbea2b59676ef83a4

v1.0.53 · 2026-04-13

Summary

  • Helix redesigns the workspace shell with a unified multi-workspace/multi-mode keep-alive architecture, pill-style Chat/Manager switcher in the title bar, responsive 2-column workspace selector, and numerous performance and UX improvements.
  • Helix-agent improves context cache efficiency with a 200k absolute token limit, dual-condition cache trim, parallel BuiltinMCP startup, and reduced workspace connection overhead.

Helix

  • Added: Unified shell architecture — multiple workspaces × multiple modes stay alive and switch instantly without reloading.
  • Added: Chat/Manager toggle redesigned as a compact pill-style switcher in the title bar.
  • Added: macOS subwindow now uses WorkspaceShellPage for consistent chat/manager navigation.
  • Added: Workspace selector responsive 2-column grid layout for desktop; last row fills full width for odd-count items.
  • Added: Background task list uses AnimatedList with position locking to prevent jumping; subagent tasks support click-to-view subagent progress.
  • Added: Personal center usage records now display cache-hit token count.
  • Added: Tooltip for project/worktree dropdown items in Changes Review dialog.
  • Changed: Workspace dropdown restored as a full-width independent row; Chat/Manager switcher moved into the title bar.
  • Changed: Optimistic navigation for chat pages; removed redundant loadSessions call.
  • Performance: Longterm subwindow open time reduced via parallel data load and animation separation (P0+P1).
  • Performance: Loopback detection parallelized with global pairing status timeout.
  • Performance: Personal center API calls load step-by-step and refresh UI independently on completion.
  • Fixed: Streaming refresh — 4 bugs resolved (per-session watchdog guard, race condition, isClosing check, sub-window notifier).
  • Fixed: Chinese character truncation in background task previews replaced with safe rune-level truncation.
  • Fixed: Longterm chat badge stuck in endless loading state after cancellation.
  • Fixed: scrollToBottomOnInit — added maxScrollExtent stability detection and hasClients retry mechanism.
  • Fixed: Subagent popup window stuck on loading (non-blocking WebSocket in registerLiveSession).
  • Fixed: Workspace selector single-item visual centering alignment bug.

Helix-agent

  • Performance: Context cache token threshold now enforces a 200k absolute upper limit.
  • Performance: Cache trim uses dual-condition trigger; tools list now includes cache_control header.
  • Performance: Removed unnecessary GetSessionManager() call in ConnectWorkspace.
  • Performance: BuiltinMCP services now start in parallel; eliminated serial sleep delays on startup.

Repository commits

  • agentui: 4087027e306c878c44b7faf70d00615b25e3a72b
  • aiagent: 96d85a64cf9f624aeba637f0967abf457b38009c

v1.0.52 · 2026-04-12

Summary

  • Helix fixes a race condition in Dream Mode where the selected model would immediately revert to empty after selection due to polling timer reinitialization on widget rebuild.
  • Helix-agent has no changes in this release.

Helix

  • Fixed: Dream Mode model selector race condition — selected model no longer reverts to empty immediately after selection.
  • Fixed: refreshDreamStatus and polling timer are now initialized only on first build, preventing Dropdown interaction from resetting the polling timer and overwriting the local state.
  • Fixed: Optimistic updates in updateDreamModel, setDreamEnabled, and setDreamAutoEnabled now write locally before HTTP, blocking stale server responses from overwriting the UI state.
  • Fixed: Replaced _pendingDreamConfigWriteKeys (Set) with a reference-counted Map to correctly handle concurrent write operations without premature flag clearing.
  • Fixed: Optimistic update failures now correctly roll back to the previous value.

Helix-agent

  • No changes.

Repository commits

  • agentui: cab951658d5ca7006597e82866710f230891a7d3
  • aiagent: df90226603f7a0536635aacff2c9131c4026d0b2

v1.0.51 · 2026-04-12

Summary

  • Helix adds a full custom prompt management UI, model selector in the Polish editor, icon-switch copy feedback, and auto-scroll to latest message on popup open.
  • Helix-agent adds custom prompt management API, daemon parameter for execute_shell, and fixes Anthropic message sanitization, unmatched tool_use block dropping, and fork session inheritance.

Helix

  • Added: Custom prompt management page (create, edit, delete custom prompts).
  • Added: Model selector in Polish editor, forwarding modelId to the polish API.
  • Added: "Customize" navigation entry at the bottom of PromptSelector.
  • Added: Popups and overlays auto-scroll to the latest message on open.
  • Changed: Copy button now uses icon-switch feedback instead of a snackbar.
  • Fixed: Model selector not shown in Polish editor; resolved by reading ChatController from caller context.
  • Fixed: CustomPromptController now refreshes after workspace connection.
  • Fixed: Desktop save-dialog cancel now shows user feedback instead of silently ignoring.

Helix-agent

  • Added: Custom prompt management API (/api/custom-prompts), included in agent auth whitelist.
  • Added: Polish API now accepts optional model in request body, falling back to workspace default.
  • Added: daemon parameter for execute_shell tool to prevent longterm sessions from blocking on persistent service processes.
  • Fixed: Drop unmatched Anthropic tool_use blocks to prevent API errors.
  • Fixed: Sanitize Anthropic message history before sending to remove invalid entries.
  • Fixed: Fork manager session now correctly inherits allowed_agents and ToolLinks.
  • Fixed: Filter noisy gin HTTP status log entries.

Repository commits

  • agentui: b17d184f890d14adde865e58dd689a130327525c
  • aiagent: 82fe01bb689aa1da2f430d4164beb2c456819130

v1.0.50 · 2026-04-11

Summary

  • Helix adds Dream Mode auto-consolidation toggle, workspace-level model route group preferences, unified Select Agent entry, worktree-aware project/worktree dropdowns in the git-diff dialog, and several manager page fixes.
  • Helix-agent implements Dream Mode auto-trigger, MEMORY.md injection, workspace-level modelRouteGroupPrefs, full linked-worktree support in the workspace scanner, and fixes manager cancel propagation and clean-worktree preview inclusion.

Helix

  • Added: Dream Mode auto-consolidation toggle in frontend.
  • Added: Disabled all Dream Mode action buttons when Dream Mode is off.
  • Added: Unified Select Agent entry integrating model selection and execution agents in manager.
  • Added: Manager sessions can now see background tasks initiated by longterm sub-sessions.
  • Added: Workspace-level modelRouteGroupPrefs global config UI.
  • Added: Split repo selector into project + worktree dropdowns in CurrentChanges dialog.
  • Fixed: Filter system-reminder injected messages from chat view.
  • Fixed: Longterm progress not restored when re-entering manager page.
  • Fixed: Inline ModelDropdown chip in popups instead of expanded list.
  • Fixed: Align _wsHandleCancelled with longterm sub-session state cleanup.
  • Fixed: Duplicate message display bug in manager page.
  • Fixed: Worktree selector now uses last segment of branch name as label.
  • Fixed: Project selector prefers main repo entry as representative.

Helix-agent

  • Added: Dream Mode auto-trigger implementation.
  • Added: Dream Mode Run() guarded with Enabled gate; returns ErrDreamDisabled when disabled.
  • Added: Incremental session filtering by lastConsolidatedAt in Dream Mode.
  • Added: MEMORY.md injection mechanism for persistent memory context.
  • Added: Workspace-level modelRouteGroupPrefs global config.
  • Added: Full linked-worktree support in workspace scanner (IsLinkedWorktree, WorktreeName, MainRepoId).
  • Added: Include clean worktrees in preview results when sibling worktrees have changes.
  • Fixed: Manager cancel correctly propagates to longterm sub-sessions.
  • Fixed: Linked worktree now uses main repo directory name as its name.
  • Fixed: UTF-8 safe truncation for session lastMessage preview text.
  • Fixed: Dump Anthropic 400 request bodies to crash dir for debugging.

Repository commits

  • agentui: e7541f6ca50b91446636aa72febeff6b7585f765
  • aiagent: 934b251fdd1c95c53ec87695e2c215e0d7c2a299

v1.0.49 · 2026-04-11

Summary

  • Helix introduces Dream Mode with a "View Conversation" entry, adds a file switcher and inline editor in skill detail dialog, adds session export with i18n support, and fixes the backend log tab not showing on Windows.
  • Helix-agent introduces Dream Mode backend, embeds builtin skills into the binary with file read/write API for skill detail, adds session export API with timestamp tracking, and fixes empty Anthropic content block filtering and subagent LLM response guards.

Helix

  • Added: Dream Mode frontend UI with "View Conversation" entry.
  • Added: File switcher dropdown and inline editor in skill detail dialog.
  • Added: Export session feature with i18n support (English/Chinese error keys).
  • Fixed: Backend log tab not showing on Windows.
  • Fixed: _exportSession duplicate declaration and missing _TemporaryTaskMenu implementation.

Helix-agent

  • Added: Dream Mode backend implementation.
  • Added: Builtin skills embedded into binary; user skill directory seeded on startup including all attachment files.
  • Added: File read/write API for skill detail view.
  • Added: Skill-creator attachment files included in builtin skills.
  • Added: Export session API with timestamp tracking on all message types.
  • Fixed: Empty Anthropic content blocks filtered consistently.
  • Fixed: Guard against empty subagent LLM responses.
  • Fixed: UsesThinking() now returns useThinking field for semantic consistency with GetUseThinking().
  • Fixed: SubAgent thinking mode correctly passed to Runner to avoid restricted routing.
  • Fixed: Missing Timestamp field in saveMessages.

Repository commits

  • agentui: 44d25127f7c159b3cf4e74d7f9c31792b19faf73
  • aiagent: 0ee1596dcbbc6946dc4a013e59470e7f3c5dd636

v1.0.48 · 2026-04-10

Summary

  • Helix polishes the todo empty-state card by replacing the gradient background with a solid color and adding a subtle border for clearer visual hierarchy.
  • Helix-agent hardens session persistence by guarding all storage saves against tombstoned sessions, adding timestamps to all message types, fixing a session-delete resurrection race, and normalizing empty Anthropic tool inputs.

Helix

  • Fixed: replaced gradient background on todo empty-state card with solid color for a cleaner look.
  • Fixed: added a subtle border to the todo empty-state card to preserve visual hierarchy.

Helix-agent

  • Fixed: guarded all storage.Save calls with tombstone check to prevent deleted session resurrection.
  • Fixed: session delete resurrection race condition.
  • Added timestamps to all message types for more accurate storage tracking.
  • Fixed: normalized empty Anthropic tool input maps to prevent nil pointer panics.

Repository commits

  • agentui: 44951cde0b1ef4e2ede9a3fad9f1d071e1f23bf2
  • aiagent: b04392f953ec6239debe32a6507970a499e4b896

v1.0.47 · 2026-04-10

Summary

  • Helix fixes background-task dialog cancel button unresponsiveness, occasional scroll-to-bottom button disappearance, and markdown white-screen crash; refactors system-tab update checks into a standalone frontend update widget.
  • Helix-agent hardens HTTP 400 retry handling to prevent false-positive retries from destabilizing the response stream.

Helix

  • Fixed: background task Dialog cancel button not responding.
  • Fixed: scroll-to-bottom button occasionally disappearing in chat.
  • Fixed: CRLF line endings causing white screen during markdown parsing.
  • Refactored system tab to use standalone FrontendUpdateWidget showing only frontend version, check and download update.

Helix-agent

  • Fixed: increased HTTP 400 retry cap and hardened stream error handling.
  • Fixed: added HTTP 400 to retryable errors with safeguards to prevent infinite retry loops.

Repository commits

  • agentui: 8881a88683dab9b052c449bb88bb50fa90bda32a
  • aiagent: cdbc736cb8c1b4ba66365d5fe65cbc5ebc547e41

v1.0.46 · 2026-04-09

Summary

  • Helix adds a "hide thinking content" toggle, makes Enter-to-send the default on first install, and adds a settings entry with theme color picker to the selector page.
  • Helix-agent fixes nil tool argument panics and auto-reloads skills when a new session is created.

Helix

  • Added "Hide thinking content" toggle to suppress Claude reasoning blocks in chat.
  • Fixed: empty lines no longer appear when thinking content is hidden.
  • Added settings entry and theme color picker to the selector page.
  • Changed "send on Enter" to be the default on fresh installs.
  • Fixed: added /api/drives to agent credential whitelist.
  • chore: removed jni from generated_plugins (Linux & Windows).

Helix-agent

  • Fixed nil tool argument map panic.
  • Auto-reload skills when a new session is created.

Repository commits

  • agentui: 327e349e2efc683c9a3fb4aac34dc8cfdf534ca3
  • aiagent: 4e1e4799f9da5a6765f899060d29cc5b774a23c7

v1.0.45 · 2026-04-09

Summary

  • Helix upgrades chat rendering to the full-feature renderer and fixes the "delete from account" button appearing incorrectly after logout.
  • Helix-agent has no changes in this release.

Helix

  • Refactored chat rendering: removed lightweight mode, messages now always use full-feature renderer.
  • Fixed: hide "delete from account" button after logout.

Helix-agent

  • No changes in this release.

Repository commits

  • agentui: 046db79b9a85e0d23fbfea21321eaadec9e56a46
  • aiagent: be3bef9d43c7755f7d5f6c6b6dcac8dffcb576c5

v1.0.44 · 2026-04-09

Summary

  • Helix adds self-host device renaming, changes preview and task dialogs, and fixes UI refresh on tier switching, server deletion resurrection, chat metrics, and terminal sync.
  • Helix-agent adds async git preview scan API and exposes runtime type in version info.

Helix

  • Added self-host device rename flow.
  • Added changes preview and task dialogs.
  • Refactored desktop bundled runtime update handling.
  • Fixed tier switching not triggering UI refresh.
  • Fixed self-hosted server deletion resurrection.
  • Fixed chat first-screen metrics.
  • Hardened chat terminal sync fallback.

Helix-agent

  • Added async git preview scan API.
  • Exposed runtime type in version info.

Repository commits

  • agentui: a213eb3cdc23b66d648e71f22621ad26bb3b2444
  • aiagent: be3bef9d43c7755f7d5f6c6b6dcac8dffcb576c5

v1.0.43 · 2026-04-08

Summary

  • Helix fixes chat projection collapse boundaries and improves Windows drive discovery in workspace browser.
  • Helix-agent carries forward unchanged from v1.0.42.

Helix

  • Fixed chat projection collapse boundaries to prevent incorrect message grouping.
  • Fixed Windows drive discovery in workspace browser for more reliable path resolution.

Helix-agent

  • No Helix-agent changes in this patch release.

Repository commits

  • agentui: b6f65b8a4b00a38f3e4c0ba77aca11e5c36f3043
  • aiagent: f52ec09131d1c9651d3cbcc92236d4d8a6295481

v1.0.42 · 2026-04-08

Summary

  • Helix carries forward the latest desktop, mobile, and web client release without additional UI changes in this patch.
  • Helix-agent improves browser detection visibility in Snag so runtime environment state is easier to diagnose.

Helix

  • No Helix UI changes in this patch release.

Helix-agent

  • Surfaced browser detection state in Snag to make backend/browser runtime diagnosis clearer.

Repository commits

  • agentui: c33fe153a7354936b257ef705ef36800ff373692
  • aiagent: f52ec09131d1c9651d3cbcc92236d4d8a6295481

v1.0.41 · 2026-04-08

Summary

  • Helix improves self-hosted workspace binding stability, fixes workspace grouping across same-url devices, and reduces duplicate auth-expiry relogin prompts.
  • Helix-agent improves workspace isolation for longterm callbacks and stabilizes workspace event delivery by buffering broadcasts.

Helix

  • Migrated self-hosted workspace bindings to use node-based association for more reliable device/workspace mapping.
  • Fixed workspace grouping for devices connected to the same URL so they are organized correctly.
  • Reduced duplicate auth-expiry relogin prompts.

Helix-agent

  • Scoped longterm callbacks by workspace to avoid cross-workspace interference.
  • Buffered workspace event broadcasts to make event delivery more stable.

Repository commits

  • agentui: c33fe153a7354936b257ef705ef36800ff373692
  • aiagent: d0ca9904f7064caa8d88f2fc8fe4859a9915b683

v1.0.40 · 2026-04-08

Summary

  • Helix adds route group selection in chat composer, shows group_ratio-aware pricing in the toolbar, and fixes longterm chat duplicate rendering, snapshot refresh, and subagent token display.
  • Helix-agent adds group_ratio support for builtin model route groups, enables thinking by default for builtin models, and stabilizes longterm background follow-up polling and completion detection.

Helix

  • Added route group selection control to the chat composer toolbar.
  • Display group_ratio-aware multiplier in route group selector (falls back to multiplier when group_ratio is zero).
  • Fixed duplicated longterm chat message rendering.
  • Fixed stale chat snapshot not refreshing after session completion.
  • Fixed stale chat message recovery on refresh.
  • Fixed subagent token limit display.
  • Fixed duplicate longterm "started" messages appearing.
  • Optimized first paint for large chat sessions.
  • Reduced repeated node-status polling in self-hosted mode.

Helix-agent

  • Exposed group_ratio field in route group API response and builtin config.
  • Persisted and forwarded route groups for builtin models.
  • Enabled thinking by default for builtin models.
  • Fixed builtin OpenAI model IDs containing colon delimiters.
  • Reduced longterm background task polling frequency for better performance.
  • Fixed longterm completion: wait for truly quiescent state before finishing.
  • Throttled longterm background follow-up polling to reduce load.
  • Compensated for queued background followups to prevent premature completion.
  • Fixed responses: preserve streamed outputs when the completed output is empty.

Repository commits

  • agentui: c6be8d68814feb78e31d37ae7ceef5d9e70a2bc6
  • aiagent: 08885815b0f84ea6e671a0872a872effbb4a9081

v1.0.39 · 2026-04-06

Summary

  • Helix improves longterm chat rendering with live image updates and deduplicated background/tool messages.
  • Helix-agent propagates images to longterm chat events and adds regression tests for background follow-up flows.

Helix

  • Rendered longterm chat images from live events.
  • Deduplicated background task and longterm tool messages.

Helix-agent

  • Propagated images to longterm chat events.
  • Added tests for websocket background task enqueueing and longterm background follow-up races.

Repository commits

  • agentui: 6231d2af41f8b53f5de4d13e83e38e21b83b9fb9
  • aiagent: 27e16ddf2c18dddc1869f23cd0d6d51a9fdc1e9d

v1.0.38 · 2026-04-05

Summary

  • Helix restores live markdown rendering, refreshes chat images from history snapshots, and fixes chat session cache synchronization.
  • Helix-agent preserves subagent image attachments and improves longterm chat stability by fixing event channel overflow handling.

Helix

  • Restored live markdown rendering in chat.
  • Refreshed chat images correctly from history snapshots.
  • Fixed chat session cache synchronization.

Helix-agent

  • Preserved image attachments when flowing through subagent execution.
  • Fixed longterm chat event channel overflow handling for better runtime stability.

Repository commits

  • agentui: dbfd1c883c55dbfcfc9ed7ae5b1f33ded7226796
  • aiagent: eb08308fd7b7c9399a94c3836abe5bc501f28116

v1.0.37 · 2026-04-05

Summary

  • Helix improves chat/session responsiveness, stabilizes terminal and SSH dialog lifecycle behavior, and continues the controller refactor for maintainability.
  • Helix-agent adds v2 WAL-backed session storage, speeds up session-history projection, and fixes provider-specific effort mapping plus active-turn projection stability.

Helix

  • Improved chat and long-session rendering/loading performance.
  • Fixed terminal panel and SSH dialog lifecycle issues.
  • Continued refactoring chat, editor, workspace selector, payment result, and personal center flows to simplify controller structure and maintenance.

Helix-agent

  • Added v2 WAL-backed session storage and migration support.
  • Improved session history performance by precomputing message projection.
  • Fixed projection logic so active turns are not collapsed incorrectly.
  • Fixed provider-specific effort mapping and trace logging.

Repository commits

  • agentui: d653406cbc75c0454b4f48d32f37b68bb3a0b263
  • aiagent: ae1e1349b4423204237b21e2a25c2a16ac539511

v1.0.36 · 2026-04-02

Helix-agent

  • Fixed context cache corrupting Anthropic tool rounds that contain thinking blocks: tool calls associated with thinking assistant messages are now preserved intact instead of being pruned, preventing "thinking blocks cannot be modified" errors.
  • Fixed orphan tool result messages being sent to Anthropic after cache restore or race conditions, preventing "unexpected tool_use_id" errors.
  • Fixed message history restoration after cached send: new assistant tool calls are no longer lost when context cache compresses the prepared history shorter than the original.

Repository commits

  • agentui: b8b0a7d4707611575948da5cee85990418f6e437
  • aiagent: 083b0022d52cd5925f857196d1150ef26168761a

v1.0.35 · 2026-04-02

Helix-agent

  • Fixed Claude context window inference: Opus models use 1M, Sonnet and other Claude models correctly use 200K (was incorrectly set to 1M for all variants).

v1.0.34 · 2026-04-02

Summary

  • Helix adds a pricing page, SSH connection editing, on-demand background task output loading, and multiple longterm-chat reliability fixes.
  • Helix-agent adds background task inspection tools, auto-backgrounding for shell and subagents, MCP session inspection, and improves response handling reliability.

Helix

  • Added a pricing page accessible from the personal center profile entry.
  • Added SSH connection delete and edit functionality in the SSH management view.
  • Background task output now loads on demand, reducing unnecessary data fetching.
  • Left-side list panels on the manager and chat pages now expand by default.
  • Fixed multiple longterm-chat reliability issues: session-switch progress recovery, real-time message updates during execution, and progress panel blank-screen on re-enter.
  • Fixed longterm chat progress bar being lost after session switch or workspace re-entry.
  • Fixed chat view reuse when switching sessions.
  • Fixed workspace-isolated auto-compress settings and increased AI model max output tokens to 40000.
  • Fixed managed backend log rotation and refined pricing table display.

Helix-agent

  • Added background task inspection tools, allowing agents to query and monitor running shell and subagent tasks.
  • Added auto-backgrounding for long-running shell commands and subagent invocations to prevent blocking.
  • Added session inspection tools to the subagent MCP, enabling live session introspection.
  • Probes built-in MCP tool availability from live servers.
  • Persists active state for longterm tool links across sessions.
  • Fixed orphan tool outputs being dropped before response completion.
  • Fixed background task session routing.
  • Added SSH connection update API (PUT /api/remote/connections/:name).
  • Increased all built-in model MaxOutputTokens to 40000 and Claude series ContextWindow to 1,000,000.
  • Improved WebSocket broadcast buffering and save timing logs for better performance.

Repository commits

  • agentui: b8b0a7d4707611575948da5cee85990418f6e437
  • aiagent: 0813be9de63d05bcf9e6cce16f1f9863539229e1

v1.0.33 · 2026-03-28

Summary

  • Helix adds a desktop workbench flow, faster startup and session loading, restored mobile thinking controls, and several UX polish updates.
  • Helix-agent adds a directory creation API for pre-workspace setup and restores reviewer guidance behavior in code-review flows.

Helix

  • Added a desktop workbench layout with improved editor, file-tree, and mkdir flow for local project operations.
  • Accelerated startup by parallelizing WebSocket connect and history loading, and increased initial session-list fetches for faster access to older chats.
  • Restored mobile thinking controls in the composer.
  • Improved responsive layout behavior, fixed cloud-container WebSocket authentication, and polished payment redirect plus startup theme persistence.
  • Updated top-up currency defaults to follow the app language automatically.

Helix-agent

  • Added /api/mkdir support so clients can create directories before workspace creation.
  • Restored subagent reviewer guidance behavior for code-review flows.

Repository commits

  • agentui: eff04df8f9fc1afc4f1b90806db7f5587e3d86f4
  • aiagent: eae3c0d1430ffd546132414fb4b493963d39e1e1

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

v1.0.32 · 2026-03-26

Summary

  • Helix improves workspace sync and reconnect recovery, adds SSH key login for remote sessions, and polishes mobile and todo-panel experiences.
  • Helix-agent makes frontend-triggered retry cancellation more reliable, restores background task callbacks after reconnect, and hardens SSH reconnect handling.

Helix

  • Added SSH key authentication support in the remote session dialog.
  • Improved workspace sync and device reconciliation across cloud/local flows, including node identity normalization, synced workspace visibility, and automatic upload/bind of local metadata.
  • Improved reconnect and manager recovery so live cards, longterm tool state, and mobile session restore behave more reliably after reconnects.
  • Improved mobile adaptation in the personal center, manager flows, and selector-related pages.
  • Added a todo tab in the right-side snippets area and polished todo animations, interactions, and empty-state visuals.
  • Reduced selector refresh churn and throttled latency probing to improve stability when returning to the app.

Helix-agent

  • Fixed provider retry loops so cancellation from Helix now stops retries promptly.
  • Fixed workspace reconnect flow by rebinding background task callbacks after reconnect.
  • Hardened remote SSH reconnect handling and reduced exposure of connection secrets.

Repository commits

  • agentui: 9fc4a5540ae5fa3ed2eadf7975a460df68ebb942
  • aiagent: 6d2dcc1ebf7c5b17cf22eb8906c85e1567a7cd14

v1.0.31 · 2026-03-24

Summary

  • Helix sharpens the manager workflow with a faster board, better mobile adaptation, richer WeChat integration, clearer runtime/update controls, and more reliable self-hosted device sync.
  • Helix-agent adds WeChat inbound polling and reply bridge support, expands runtime metrics and title-model controls, improves self-host token/gateway recovery, and preserves session/image continuity more reliably.

Helix

  • Added a full WeChat bot settings flow, including QR pairing, bilingual binding guidance, local QR rendering, sent/received message list improvements, and automatic completion after QR login.
  • Added manager-board capabilities such as realtime workspace subscriptions, attention states, bulk completion actions, and a direct dialog entry from the selector.
  • Improved manager-board and manager-page performance to reduce mobile lag and speed up reopen/loading.
  • Expanded runtime/settings visibility with backend memory metrics, active session counts, aggregated runtime activity, title-generation model selection, and a managed backend installer/update flow.
  • Improved mobile adaptation across dedicated pages, cloud containers, selector layout, and chat/session flows, while preserving drafts and optimistic messages during reconnect or resize.
  • Improved self-host/device management by supporting direct+tunnel cloud sync, tunnel access URL display, rotate-credential actions, binding-status display, refresh behavior, and safer cloud/local reconciliation.
  • Added Stripe top-up flow in the personal center and refined TTFT / duration metrics display.
  • Fixed editor, selector, homepage, and chat UI issues including minimap interaction, code-block styling, compile regressions, and noisy websocket/thinking logs.

Helix-agent

  • Added WeChat openclaw pairing, bound-manager reply push bridge, and background inbound polling with relogin/reset test coverage.
  • Added configurable title-generation model support plus runtime metrics for memory, active sessions, root/sub-agent counts, and aggregate client activity.
  • Improved self-host reliability with domain-safe gateway node IDs, persisted service address refresh, and recovery from expired refresh tokens.
  • Fixed persisted session restoration after restart so saved conversations recover more reliably.
  • Fixed deferred longterm tool image forwarding to preserve image delivery in delayed execution paths.
  • Improved manager/agent prompt layering and increased provider retry limits for better resiliency under transient failures.
  • Fixed WeChat send flow to reuse persisted context tokens correctly.

Repository commits

  • agentui: 1614c37650d2c37030455f4b34b9d5685ddd5677
  • aiagent: 472e0dfe14194f96c18f282cc4a5b6f4d652fdae

v1.0.30 · 2026-03-20

Summary

  • Helix adds clipboard image paste, broader drag-and-drop coverage, better multi-window image delivery, and simplifies the workspace tunnel flow with direct subdomain support.
  • Helix-agent improves image forwarding through manager/sub-agent and longterm flows, adds automatic subdomain enrollment/bootstrap, stabilizes Anthropic cache routing, and hardens browser-tool timeouts.

Helix

  • Added desktop chat support for pasting clipboard images directly into conversations.
  • Added a fallback that prefers clipboard file references when pasting images for more reliable attachment handling.
  • Expanded chat drag-and-drop coverage to the full chat area for easier image drops.
  • Fixed multi-window image drag-and-drop so images are sent only to the currently active window.
  • Fixed macOS desktop image drag-and-drop in headless engine mode.
  • Simplified workspace tunnel behavior by removing legacy TCP tunnel code.
  • Added direct/tunnel toggle support for subdomain tunnels and writes subdomain URL bindings for sync.
  • Switched the device management entry to the selector bottom bar and removed the legacy tunnel entry.

Helix-agent

  • Fixed image forwarding so resumed manager sessions correctly pass images to sub-agents.
  • Fixed longterm_chat and run_subagent image propagation bugs caused by []string type assertion failures.
  • Added per-device certificate bootstrap via /api/node/csr and automatic enrollment support for subdomain-based tunnels.
  • Added built-in default gateway support and automatic re-enrollment when the gateway address changes.
  • Removed legacy EnrollNode handler and obsolete /selfhost/node-enroll route.
  • Relaxed Validate credential pre-checks to allow CSR bootstrap flows.
  • Stabilized Anthropic session affinity to improve cache routing consistency.
  • Enforced a total timeout across the browser-tool Snag flow to prevent hangs.
  • Fixed and refreshed flaky Go tests for a clean full test pass.
  • Fixed longterm interject persistence races that could drop inserted messages.

Repository commits

  • agentui: 2d861fd1bf26469f0817d8c0b21d19cf5cdde7df
  • aiagent: 13e2fbc05ac7e049efcac736ee04b54350d9d990

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