Changelog
HexClaw Desktop version history.
v0.4.9 (2026-07-04)
- Desktop and backend versions are aligned on v0.4.9; the bundled sidecar now builds from hexclaw v0.4.9 by default
- Agent improvements: structured SOUL editor, skill picker, advanced parameters, and safer edit-lock states
- Chat hardening: session branching, safer delete/export actions, persisted thinking duration, and tool-only message fallback
- Automation and connections: permission controls, schedule validation, MCP status refresh, and per-instance channel binding fixes
- Runtime fixes: graceful sidecar shutdown, memory behavior settings, inlined splash logo, and relaxed heavy-view test timeouts
v0.4.8 (2026-06-28)
- Ordered content blocks: thinking, text, and tool calls now render interleaved in causal order, with new tool-call cards and a sub-agent panel
- Snappier sending: your message appears on screen instantly and is no longer blocked by the knowledge-base lookup (Auto-RAG) round-trip
- IM channels bind to an Agent: a channel binds directly to an Agent, with the model managed as an Agent property
- Knowledge base: visual RAG retrieval settings, date-range filtering, and pagination
- New continuous tasks: long-running tasks that keep making progress across cycles
- Text-to-speech is on by default on desktop (free edge-tts) and can be interrupted and retried
- Workflow runs can resume after a failure, reusing already-completed nodes
- Memory unified into a single FileMemory; long-term memory now lives on the "Long-term Memory" page
- Engine upgraded to hexclaw v0.4.8
v0.4.7 (2026-06-26)
- Error replies and like/dislike feedback now persist — they survive session switches and reloads, and feedback stays actionable
- Text-to-speech failures now show a clear toast instead of silently doing nothing
- Degeneration circuit breaker: detects and stops degenerate model output from polluting the conversation
- In-app document download & preview: downloads use the native save dialog; PDF parsing moved to the backend, so the frontend no longer bundles pdfjs
- Interaction fixes: no false scroll-nav on new sessions, IME-composition Enter no longer mis-sends, and the session model no longer leaks across sessions
- Engine upgraded to hexclaw v0.4.7
v0.4.6 (2026-06-23)
- MCP in the Connections hub: an MCP server's env credentials (DB passwords, API keys, etc.) are encrypted at rest with a master key; API responses are always redacted
- Graceful max-turns handling: when the tool-call turn limit is reached, partial results are returned with a "continue" hint instead of throwing an error; default turn limit raised to 25 (hard cap 50)
- File-memory mount fix: newly added memories are injected without a restart and take effect immediately
- Desktop notifications now carry a source tag (cron / IM) so the UI can map icons and deep links
- Engine upgraded to hexclaw v0.4.6 (Hexagon v0.5.3); Skills hub default branch bumped to v0.0.5
v0.4.5 (2026-06-22)
- Connections hub (channels & accounts + data connectors): channel cards reuse IM instances and email (SMTP/IMAP auto-configured by domain), encrypted locally — "store once, reference anywhere"
- Data connectors (GitHub / Notion): read-only token access with real connection tests and resource browsing; tokens encrypted at rest server-side, responses redacted
- Real linear-workflow editor: create / add / remove / reorder / edit steps, save, and dry-run with per-node status filled back live
- Cron delivery-target picker: choose a configured instance from the connections library
- Edit the default assistant persona (SOUL): read/write
~/.hexclaw/SOUL.mdas plain text, with restore-to-default - Prompt library (
/to summon,$ARGUMENTSparams), drag/paste images into the composer for vision, ⌘K command palette, global engine-disconnected fallback banner - Unified shared components and brand tokens, grid-card hover motion; full coverage in Simplified Chinese / English / Uyghur (RTL)
- Windows builds now ship NSIS (
.exe) only — no more.msi; Windows no longer bundles Ollama (guided separate install instead) - Fixes: bottom-left engine version display, log trace_id label overlap, added the common.saving key across all three languages
v0.4.2 (2026-06-16)
- Navigation IA overhaul: Chat pinned on its own + "Build / Connect / System" groups
- Skill detail shows SKILL.md read-only; terminology unified to "Skills"
- Knowledge-base document viewer renders Markdown; code blocks get wrapping, light bare-fence styling, and hover-to-copy
- Webhook handles the not-enabled state + navigation routing sync; session write API contract unified
- pandoc / typst moved to Tauri sidecars with download integrity checks; Windows release build fixed (render-bundle.sh works under git-bash)
v0.4.1 (2026-06-03)
- Code-view rendering & download + bundled pandoc / typst rendering chain
- Unified cron scheduled-task architecture + end-to-end SSE streaming compilation
v0.4.0 (2026-04-30)
- Major refactor · unified text composer: removed the standalone image/video generation composers and the generation-parameter panel; every path now routes through a single ChatInput, matching the ChatGPT / Claude / Gemini paradigm (image/video use default parameters)
- Uyghur (ug) RTL support: 1330 i18n keys mapped 1:1 with Simplified Chinese, auto-setting
<html dir=rtl lang=ug>; a global unicode-bidi: plaintext fallback keeps mixed CJK/Latin/number runs correctly oriented, while code / pre are forced LTR - Apple HIG alignment across five dimensions: borders ≤1.5px, shadow alpha ≤0.12, explicit transition properties, pure Apple system font stack, accent-glow alpha ≤0.18
- Media download / preview: unified download button for images/videos (always visible at 0.85 opacity, RTL-safe positioning), click for a full-screen lightbox
- Background generation → local disk → URL reference: outputs are written to generated/ and the frontend prefers never-expiring local URLs, avoiding base64 bloating the database
- New Interactive components (Buttons / Select / Approval / Card / Block) + the message.interactive protocol
- Backend hexclaw v0.4.0: Feature Flags / Skill Pipeline / model-capability probing / event transport v1 / model gateway v1 / tool lifecycle v2
v0.3.8 (2026-04-14)
- Image generation: ZhipuAI CogView-4 support, images embedded as data URI (never expire), new ImageProvider interface in ai-core
- Video generation: ZhipuAI CogVideoX-2 support, async task polling, cover embedded + inline video player, new VideoProvider interface in ai-core
- Tool name i18n: 15 built-in tools mapped to localized names (code_exec → Sandbox, etc.), unknown MCP/custom tools fallback to raw name
- Default model fix: normal chat no longer overridden by default Agent model preference, Agent mode shows agent name attribution
- Multiline memory fix: memory entries with newlines no longer split into multiple entries, delete/update/archive support multiline blocks
- Ollama download optimization: large models no longer timeout (ResponseHeaderTimeout replaces global Timeout), download status localized
- Smart routing UI: strategy dropdown hidden when routing is disabled
- Feishu reactions: changed from social emojis (💪☕🔥) to semantic Typing ⌨️ / THINKING 🤔
v0.3.7 (2026-04-13)
- Thinking duration persistence: backend precisely records reasoning start/end time, persisted in DB meta field
- Auto session title: backend generates title from first user message on SaveUserMessage (no LLM dependency)
- Metadata persistence: provider, model, agent_name saved to message meta — survives app restart
- ChatGPT-style thinking display: "● Thought for Xm Ys" with left border on expanded content
- UI: assistant messages without bubble, meta footer (time · model · agent) in one line, adaptive width
- Sandbox network hot-reload: full pipeline from Settings toggle → API → CodeExecSkill.UpdateNetwork
- File tools workspace constraint: file_edit/grep/glob restricted to workspace with symlink escape prevention
- Self-correction loop: tool errors include full reason for LLM to self-correct
- Context compression: LLM + heuristic summarization preserving user constraints
- Gemma 4 thinking support: isLocalThinkingModel for timeout protection, no /no_think injection
- 70+ new backend tests, 3542 frontend tests passing
v0.3.6 (2026-04-11)
- Streaming scroll: allow upward scrolling during streaming output without auto-scroll interruption
- Agent/IM UI: optimized Agent selector and IM channel configuration interface
- New session send fix: resolved bug where first message in new session failed to send
v0.3.5 (2026-04-06)
- Ollama auto-warmup: automatically load first downloaded model on startup, reducing first-chat latency
- Historical message think tag fallback: strip <think> tags when loading messages from backend, preventing raw reasoning text exposure
- MCP filesystem dynamic home dir: auto-append user home directory when installing filesystem MCP server, compatible with macOS/Windows/Linux
- TS2532 non-null assertion fixes: type-safe array index access for models[0] / chips[0]
v0.3.4 (2026-04-06)
- Sidebar engine version display fix: watch sidecar ready state before fetching version info
- Unified version management: sync Cargo.toml / package.json / Sidebar / AboutModal versions
v0.3.3 (2026-04-06)
- Version display overhaul: Sidebar, About modal, and System Status all use Tauri App version API
- API type alignment: getVersion return type includes engine_version field
- MCP filesystem dynamic home dir: resolveUserHome cross-platform home directory detection
v0.3.2 (2026-04-06)
- <think> tag fallback extraction: models like glm-z1-airx embed reasoning in content, frontend auto-splits to reasoning field
- Adaptive dialog width: Settings dialogs auto-resize based on content
- Sidecar restart retry: automatic retry on failure for improved stability
- CI test robustness: existsSync guard, localStorage getItem verification, .at() to [0] index
v0.3.1 (2026-04-06)
- Chip-style model selector: replaces dropdown menu, visually displays configured models with quick switching
- Dynamic model discovery: cloud providers auto-fetch available model lists
- 210 TypeScript type errors fixed + 139 lint errors fixed
- 61 failing tests fixed
v0.3.0 (2026-04-05)
- MCP marketplace & tool fixes: tool call pipeline fully connected, error messages properly returned
- Skill trigger optimization: improved keyword matching accuracy
- Ollama global warmup: auto-load models into memory after startup
- Ollama model management UI: download progress bar, running status panel
v0.2.6 (2026-04-01)
- Structured trace logging: Go slog-based request-scoped logs with trace_id across WebSocket → gateway → engine → LLM pipeline, frontend log panel displays trace_id + structured field tags
- Fix SessionLock deadlock: consecutive messages in same session no longer block (P0 bug — pipeStream missing unlock)
- Fix cloud model MCP tool calls lost: pipeStreamWithTools now extracts tool_calls from LLM stream result
- Thinking toggle: Brain icon in chat input bar for one-click thinking mode control, auto /no_think injection for local thinking models
- Stream cancel now works: WebSocket cancel message actually cancels backend context, stops wasting LLM tokens
- E2E test suite: TypeScript + Playwright with 41 integration tests covering 11 subsystems
- Fix SettingsView flaky test
v0.2.5 (2026-04-01)
- Thinking/Reasoning UI: stream thinking process for Qwen3/DeepSeek-R1 reasoning models with auto-expand/collapse, timer, and persistence
- Ollama local model full-chain fix: model selector shows local models, WebSocket user auth, streaming timeout optimization
- Splash screen follows system Light/Dark appearance, waits for engine ready
- CI fix: release/package workflows read HEXCLAW_REF from Makefile to lock sidecar version
- Knowledge upload UX: dialog auto-closes after file selection
- Message edit button i18n fix + size optimization
- Remove unavailable System Status tab and microphone button (Tauri WebView lacks Web Speech API)
- Homebrew install first-chat error fix (sidecar version mismatch + embedder nil panic)
v0.2.4 (2026-03-29)
- MCP Marketplace: load mcp-registry.json, type filter for skill/mcp, one-click MCP Server install
- MCP status display fix: compatible with backend servers array format, shows "connected" correctly
- Sidecar PATH injection: auto-inject Homebrew/nvm/cargo paths on macOS GUI apps
- MCP enabled by default: Manager initializes without pre-configured Servers for dynamic add
- 6-round code audit: 42 bug fixes + 8 feature completions + 474 new tests (542→1016)
- Security hardening: CSP tightened, MCP command allowlist, knowledge zip bomb protection, atomic config writes
- hexclaw-hub upgraded to v0.0.2
v0.2.2 (2026-03-29)
- LLM Provider Select with logos — 14 providers total, 6 new Chinese providers: Zhipu AI, Kimi (Moonshot), Wenxin Yiyan (Baidu), Tencent Hunyuan, iFlytek Spark, MiniMax
- Ollama one-click install flow: detect → install → auto-poll → associate model
- MCP Tab mutual exclusion fix + i18n completion
- macOS one-line install script + Homebrew Cask support
- ProviderSelect Apple HIG compliance (keyboard navigation, ARIA, viewport flip)
- 79 new tests (OllamaCard + ProviderSelect + McpView)
- Full CI lint/TS fix (83 ESLint + 59 TS errors → 0)
v0.1.0-beta (2026-03-23) - Desktop Beta Release
- Shipped the desktop beta installers for macOS, Windows, and Linux, along with first-run onboarding and default role setup
- Expanded model provider support across OpenAI, DeepSeek, Anthropic, Gemini, Qwen, Doubao, Ollama, and custom OpenAI-compatible endpoints
- Upgraded the chat workspace with multi-model switching, artifact preview, document parsing, export, and deep research mode
- Rounded out advanced capabilities including MCP tool integration, RAG knowledge bases, semantic memory, scheduled jobs, the ClawHub skill marketplace, IM channels, and security controls
v0.0.1 (2026-03-19) - Initial Release
- Multi-model chat (OpenAI / DeepSeek / Anthropic / Gemini / Qwen / Ollama)
- Agent orchestration and multi-Agent meetings
- Visual workflow canvas
- MCP protocol integration
- Knowledge base (RAG)
- Semantic memory system
- Scheduled task dispatch
- Security gateway
- IM channels (Feishu / DingTalk / WeCom / WeChat / Slack / Discord / Telegram)
- Deep research mode
- Native support for three platforms (macOS / Windows / Linux)