Upgrade Log

What changed, when it changed, and what to verify after upgrading.

This log is the public release record for imux. It tracks the current product line, the official website rollout, documentation changes, and the operating notes you should check before replacing your current build.

Current release line
v4.1.20

imux is currently stable at v2.6.21. This release clarifies the Agent Chat entry path, simplifies the top-right controls, and keeps Clavue conversations one click away from the workspace.

How to read imux releases

Use the changelog as an operating document, not just a marketing page. A good release note helps you decide whether to adopt immediately, validate first, or hold until an active workflow is done.

1. Stable line first

Treat the public version as the stable line you can standardize on for real work. Upgrade deliberately, not because a build happens to exist.

  • Check the current version label before replacing the app.
  • Prefer one approved build across a team or project cluster.
  • Use the changelog to decide when timing is safe for important work.

2. Read for impact, not for headlines

Focus on what changes your operating surface: file handling, SSH behavior, supervisor flow, model settings, or packaging.

  • Look for workflow changes before cosmetic changes.
  • Verify whether remote behavior, routing, or settings persistence changed.
  • Map release notes to your current active tasks before updating.

3. Validate with one clean path

Every upgrade should be checked in at least one controlled local workspace and one controlled remote workspace before it becomes your default daily build.

  • Open a local repo and confirm editing plus save behavior.
  • Connect one SSH host and confirm remote browsing still matches expectation.
  • Only then move critical tasks to the new version.
Release history
June 10, 2026

Agent Chat launch and titlebar cleanup

v2.6.21

This release makes the Chat surface easier to discover while reducing the clutter in the top-right workspace controls.

  • Added an explicit Chat button in the titlebar, collapsed right-edge reveal control, and workspace footer.
  • Moved the Clavue + Codex linked-mode shortcut into the creation menu so the top-right cluster focuses on the core workspace actions.
  • Updated Agent Chat panel chrome so closing the panel reads as collapsing Agent Chat instead of a generic right-sidebar toggle.
June 9, 2026

File editor launch reliability hotfix

v2.6.20

This hotfix repairs a launch-time layout loop in file editor panels so restored workspaces can render terminals and answer local socket commands reliably.

  • Fixed a launch-time layout loop in file editor panels that could keep the main thread busy and leave restored terminal panes blank.
  • Deferred hidden file editor text views so background or side panels cannot block terminal startup and prompt rendering.
  • Published a signed and notarized v2.6.20 installer with matching website download aliases, remote helper assets, and Sparkle feed metadata.
June 9, 2026

Daemon cleanup and release alignment

v2.6.19

This stable release repairs launch reliability after restored workspaces and moves the public download/update surface onto one signed installer line.

  • Cleaned up stale debug daemon/socket state that could leave historical clients crashing on launch after a previous workspace restore.
  • Reduced the severe slowdown caused by orphaned local daemon sessions accumulating hundreds of PTYs and shell processes.
  • Published a fresh stable v2.6.19 release target so website download aliases, remote helper assets, and the Sparkle feed advance together.
April 29, 2026

Clavue launch API setup update

v1.10.10

This patch release makes Clavue and Codex launch API setup clearer, easier to validate, and less dependent on optional notification hook setup.

  • Changed Clavue official API setup to show `https://www.clavue.com`, while keeping third-party mode on the Anthropic-compatible default endpoint.
  • Added clearer Official/Third-Party labels, a one-line API URL field, Use Default URL, and a Test action that saves and checks launch readiness.
  • Blocked API keys accidentally pasted into the API URL field and let linked mode launch when CLIs plus API profiles are ready, even if notification hooks are still optional setup.
April 29, 2026

Sidebar restore controls update

v1.10.9

This patch release keeps sidebar restore controls visible after the left or right sidebar is collapsed, including compact and titlebar-hidden layouts.

  • Kept the left sidebar restore button visible after collapse instead of hiding it with the titlebar controls.
  • Added a right sidebar restore button outside the hidden pane so the detail sidebar can always be reopened.
  • Published a fresh stable `v1.10.9` release target so GitHub Release assets, website download aliases, and Sparkle feed can advance together on one signed installer.
April 29, 2026

API settings save reliability update

v1.10.8

This patch release simplifies Supervisor LLM and Launch API settings so saving API URLs, models, and keys no longer depends on interactive macOS Keychain prompts.

  • Saved Supervisor LLM and Launch API credentials to protected local files instead of triggering Keychain authorization prompts.
  • Allowed API URL and model settings to save without forcing an API key, while a blank key field keeps an existing saved key.
  • Made Clear Key suppress older Keychain fallback values so cleared API credentials stay cleared.
April 29, 2026

Ghostty config fallback update

v1.10.7

This patch release restores Ghostty's normal default configuration path when imux finds an existing but empty user config file, preventing placeholder config files from suppressing terminal defaults.

  • Restored Ghostty default config loading when a discovered user config path exists but has no loadable settings.
  • Added regression coverage for explicit non-empty config loading and missing or empty config fallback behavior.
  • Published a fresh stable `v1.10.7` release target so GitHub release assets, website download aliases, and Sparkle feed can advance together on one signed installer.
April 28, 2026

Release download reliability update

v1.10.6

This patch release repairs the installer distribution path and tightens cache policy for public update metadata, so users get the current appcast and latest-release manifest instead of stale CDN or browser copies.

  • Hardened cache headers for the appcast and latest-release manifest so update checks fetch fresh metadata.
  • Repaired the website release-link flow so homepage, changelog, latest manifest, appcast, archive URLs, and versioned DMG downloads stay aligned.
  • Published a fresh stable `v1.10.6` release target so GitHub release assets, website download aliases, and Sparkle feed can advance together on one signed installer.
April 28, 2026

Agent Mesh command surface and evidence guard release

v1.10.5

This patch release strengthens supervisor-driven collaboration with a copyable Agent Mesh command brief and prevents trusted-completion reviews from passing unless they are backed by concrete terminal, session, evidence-ledger, or visual proof.

  • Added an Agent Mesh command surface in the supervisor panel for active handoffs, evidence, review rounds, touched-file warnings, risks, next actions, and stop criteria.
  • Added a trusted-completion guard so supervisor reviews cannot mark work complete from stale metadata alone.
  • Published a fresh stable `v1.10.5` release target so GitHub release assets, website download aliases, and Sparkle feed can advance together on one signed installer.
April 28, 2026

Clavue + Codex linked mode and agent mesh release

v1.10.4

This patch release upgrades imux into a clearer multi-agent workspace by defaulting linked mode to Clavue + Codex, bundling the helper scripts that let agents share context, and refreshing the public website around the new collaboration model.

  • Added bundled `clavue` and `imux-agent-mesh` helpers for linked task context, peer discovery, notes, claims, and SDK handoff.
  • Made linked-agent UI states clearer so users can see when Clavue and Codex are associated with the same workspace and install or launch a missing peer.
  • Polished the left activity rail, sidebar controls, and agent configuration surfaces for better separation and less panel overlap.
  • Aligned the website release metadata, GitHub release target, Sparkle feed, remote helper assets, and public download endpoints around `v1.10.4`.
April 26, 2026

Source control workflow polish

v1.10.3

This patch expands the source control sidebar into a faster repository operation surface with repository history, right-click actions, commit previews, GitHub commit links, and refreshed public release positioning.

  • Added a recent-commit history card with commit diff previews and compare-with-HEAD actions.
  • Expanded file and repository context menus with open changes, open file, copy summaries, safer tag creation, and branch-from-commit flows.
  • Refreshed the GitHub, npm, and official website descriptions around source-control-aware terminal execution.
  • Aligned the npm launcher, website release metadata, GitHub release target, and Sparkle feed around `v1.10.3`.
April 26, 2026

Browser drag focus stability

v1.10.2

This patch release keeps browser pointer-drag focus allowance active until mouse-up so dragged browser interactions stay focused without reopening background autofocus.

  • Held the explicit pointer focus allowance across WebKit mouse-down, drag, and mouse-up delivery.
  • Added regression coverage for direct and locally observed mouse-up paths so the allowance closes after the drag completes.
  • Aligned the npm launcher, website release metadata, GitHub release target, and Sparkle feed around `v1.10.2`.
April 26, 2026

Image-capable supervisor compatibility

v1.10.1

This patch release adds OpenAI-compatible supervisor response handling for image-capable models while keeping persisted supervisor snapshots backward-compatible.

  • Parsed normal and streamed OpenAI-compatible chat responses for supervisor flows that use image-capable models such as `gpt-image-2`.
  • Surfaced image-generation progress text and generated markdown image links in the supervisor task package without breaking older persisted workspace state.
April 26, 2026

Refreshed Settings release target

v1.10.0

This release target refreshes the Settings surface with clearer structure, search, rows, and navigation while keeping persistence and keyboard shortcut workflows intact.

  • Refreshed the Settings canvas, sidebar, search panel, cards, rows, dividers, and navigation controls for a cleaner configuration experience.
  • Prepared the public release metadata for `v1.10.0` so the website and Sparkle feed can move forward once the signed installer is generated.
April 25, 2026

Fresh 1.9 stable release

v1.9.1

This stable release moves the public installer, GitHub release assets, website download aliases, and Sparkle feed forward together on one fresh signed release line.

  • Published a fresh signed `v1.9.1` installer so the desktop app, GitHub release assets, website download aliases, and Sparkle feed advance together.
April 25, 2026

Stronger release verification and safer download history

v1.8.16

This stable release moves the public installer, GitHub release assets, website download aliases, and Sparkle feed forward together while tightening live-site verification, preserving historical download archives, and keeping remote daemon diagnostics aligned with published manifest metadata.

  • Published a fresh signed `v1.8.16` installer so the desktop app, GitHub release assets, website download aliases, and Sparkle feed advance on one release line.
  • Tightened release-site verification so the live manifest, appcast, archived DMG, latest DMG alias, changelog, homepage, and public release pages must agree before a release is considered healthy.
  • Preserved historical website download archives and remote helper release directories when syncing new release assets, so older installers and remote diagnostics stay available after a fresh release.
  • Made remote daemon status diagnostics derive their GitHub repository from the published manifest instead of relying on stale hardcoded release metadata.
  • Stopped the public nightly page from silently offering the stable installer when no nightly download URL is configured.
April 24, 2026

Fresh stable installer and lower routing sync overhead

v1.8.15

This stable release moves the public installer, GitHub release assets, website download aliases, and Sparkle feed forward together while reducing avoidable sync work in the desktop routing path.

  • Published a fresh signed `v1.8.15` installer so the desktop app, GitHub release assets, website download aliases, and Sparkle feed advance on one release line.
  • Added a repeatable GitHub Actions quality sweep helper for release validation and made the macOS compatibility workflow manually dispatchable against a chosen ref.
  • Reduced avoidable main-thread sync churn in terminal, tab, and Ghostty action routing by consolidating the remaining sync hops behind instrumented wrappers.
April 20, 2026

Bundled Codex launcher coverage and quieter remote recovery state

v1.8.11

This stable release keeps the public installer and website on one current line while tightening the packaged agent-launch surface and reducing stale UI state after remote recovery. Bundled installs now keep the Codex wrapper path intact, live terminals avoid unnecessary rebind churn on notification-only updates, and recovered SSH workspaces stop advertising failures that are already gone.

  • Bundled the `codex` launcher and the shared `imux-agent-common.sh` helper into the shipped app resources so packaged installs keep the same agent wrapper coverage as the checked-in compatibility CLI surface.
  • Stopped notification-ring-only terminal updates from forcing an unnecessary Ghostty portal rebind, reducing avoidable live terminal churn when only background attention state changes.
  • Cleared workspace-level remote SSH error notifications as soon as a connection recovers, so the sidebar and notification surfaces no longer keep showing an old failure after the workspace is healthy again.
April 18, 2026

Simpler sidebars, denser remote navigation, and stronger blank-surface recovery

v1.8.10

This stable release keeps the public installer and website on one current line while continuing the desktop cleanup work: less decorative chrome, tighter remote SSH navigation, and stronger recovery when a pane would otherwise reopen blank or lose its live terminal surface.

  • Removed the older glass-like sidebar and explorer treatments so the left rail, sidebars, and pane chrome render as simpler solid surfaces with fewer borders and less visual overhead.
  • Tightened remote SSH host and file-tree spacing toward a denser VS Code-style layout, while still allowing narrow windows to collapse the leading sidebar down to the activity rail when content space gets tight.
  • Reused the normal Ghostty attach path for background terminal prewarming and added placeholder-tab recovery for orphaned pane selections, reducing cases where a workspace focuses an empty tab or shows a persistent blank panel.
April 3, 2026

Durable session restore and stronger black-panel recovery

v1.5.2

This stable release focuses on two trust failures in the active workspace loop: imux reopening into a thinner pane set than the one you left behind, and intermittent black front panels after task-completion driven workspace churn.

  • Session persistence now keeps a richer stable snapshot and forces a full save when the last main window closes, so reopening imux is far less likely to drop previously opened conversation and workspace panes.
  • Thin lifecycle saves no longer immediately downgrade a fuller recent snapshot during restore, which makes close-and-reopen behavior much more durable for multi-workspace setups.
  • Notification-driven workspace reorders and focus jumps now request explicit render recovery, reducing the intermittent black front panel seen after task completion events.
April 3, 2026

Remote SSH workspace preservation and portal recovery hardening

v1.5.1

This stable release focuses on two interruptions that break active work: remote workspaces disappearing when the last SSH terminal exits, and terminal surfaces occasionally staying black after fast UI churn.

  • Remote SSH child-exit on the last terminal now preserves the workspace so reconnecting can resume from the same remote context instead of reopening everything from scratch.
  • Enabled the existing transient terminal portal recovery path by default to reduce black-screen failures during split changes, sidebar churn, and workspace switching.
  • Promoted `v1.5.1` across the public release surface so the website changelog, download endpoints, and GitHub release point to the same current installer.
April 2, 2026

Denser workspace polish and cleaner release surface

v1.5.0

This stable release finishes the current UI pass with a denser operator workspace layout, safer text-input handling, and a cleaner public release path for the same installer and website surface.

  • Tightened the activity rail, workspace list, and sidebar header so the main operating surface reads much closer to a dense VS Code-style layout.
  • Reduced the terminal startup banner to a compact status strip and fixed the stuck-width right sidebar path in the file inspector.
  • Scoped Return forwarding away from the affected macOS IME composition path and kept the `v1.5.0` website and release pipeline aligned around one current installer target.
April 1, 2026

Install-repair release for direct in-place upgrades

v1.2.0

This stable release focuses on the last friction point in the desktop upgrade path: moving a running copy out of the DMG or translocated location, replacing the existing app bundle cleanly, and relaunching from a supported install path.

  • Added an install-and-relaunch recovery path when imux is opened from a disk image, App Translocation, or another unsupported launch location.
  • Updated the recovery installer so an existing imux app bundle in Applications is treated as the intended replacement target instead of a blocking directory.
  • Extended updater error handling so incompatible launch locations now expose the same direct repair action instead of ending on a dead-end retry loop.
April 1, 2026

Identity hardening pass and release-surface cleanup

v1.1.0

This stable release removes the remaining inherited brand shadows from the active imux experience and tightens the release-facing path from website to installer to support.

  • Replaced inherited repository, company, and support references across the app, website, docs, and localized public strings with the current imux-owned surfaces.
  • Rebuilt the community, legal, and feedback paths so visible contact and support entry points now read as one deliberate imux product presence instead of a carried-over fork layer.
  • Aligned the packaged app, website changelog copy, and download endpoints so the latest stable installer and its public guidance point to the same release line.
March 31, 2026

Interaction reliability pass and linked-mode quick launch

v1.0.10

This stable release focuses on the parts users hit first: inactive-window click reliability, a faster Clavue + Codex launch path, and tighter alignment between the packaged app and the website release line.

  • Accepted first-click activation across the main window host, titlebar accessory host, and settings-style utility windows so buttons and toggles no longer need a second click after refocus.
  • Promoted Clavue + Codex linked mode into the titlebar control cluster and compact creation menu, using the same shared workspace launcher as the AI Command Center sidebar.
  • Adjusted release-facing website copy so the homepage and changelog describe the same new stable line before users download the installer.
March 31, 2026

Brand consistency sweep and sidebar interaction consolidation

v1.0.9

This stable release unifies active website copy around the imux brand, aligns docs and legal surfaces to current repository endpoints, and stabilizes the sidebar interaction model so workspace navigation and tool panes no longer fight each other.

  • Rebranded active docs, legal, community, and localized website strings from legacy naming to imux while keeping historical blog and changelog archive content intentionally untouched.
  • Aligned active GitHub links and release-facing website routes to the current imux repository and download endpoints.
  • Updated sidebar behavior so left navigation can stay visible while right-side tools are open, and ensured file/remote explorer editor context resets correctly on workspace switches.
March 31, 2026

Installer path hardening and release artifact verification

v1.0.8

This stable release hardens the macOS packaging path so the shipped DMG behaves like a proper drag-to-Applications installer and the release pipeline now verifies the artifact shape instead of assuming it.

  • Unified local and GitHub release packaging behind one shared DMG creation helper so release behavior stays consistent across environments.
  • Added release-time verification that mounts the DMG, checks the app bundle, validates the Applications drag target, and rejects malformed installer artifacts before publication.
  • Kept the website, release manifest, and GitHub assets aligned to the same versioned installer so operators and users see one stable source of truth.
March 31, 2026

Release packaging refresh, branded assets, and supervisor layout hardening

v1.0.7

This stable release republishes imux with the refreshed branded app assets, a clean versioned installer path, and a safer supervisor panel layout for long generated prompts.

  • Rebuilt the imux app, icon set, favicon, Apple touch icon, and website logos from one branded asset generator so app and website visuals stay in sync.
  • Aligned stable download naming around the versioned installer path so GitHub releases, the homepage, and the download manifest resolve to the same macOS package.
  • Constrained long supervisor prompt cards inside the sidebar so generated task briefs no longer blow out narrow panes or dialogs.
March 30, 2026

Brand refinement, migration shortcuts, and updater compatibility improvements

v1.0.5

The current imux stable line sharpens the product identity, smooths migration from other AI coding clients, improves in-workspace control surfaces, and hardens update behavior for older local installs.

  • Replaced release-facing iconography, welcome copy, and visible product labels so imux is distinct across app and website surfaces.
  • Added quick import actions for VS Code, Cursor, Claude Code, and Codex preferences.
  • Upgraded the source-control area and collaboration tools so fast pull, fast push, and multi-model pane creation happen inside live imux terminals.
  • Added explicit updater compatibility checks for disk-image, app-translocated, and non-Applications launches so older installs fail with actionable recovery guidance instead of vague Sparkle errors.
March 26, 2026

Documentation and multilingual website expansion

v0.0.1

The official website gained a full usage guide, a dedicated changelog page, and broader locale coverage across the public marketing surface.

  • Added dedicated /guide and /changelog routes.
  • Expanded website language coverage across all routed marketing locales.
  • Published practical setup, workflow, and upgrade instructions for imux users.
March 25, 2026

Official imux website launch

v0.0.1

The public site moved onto the imux brand and domain, with aligned downloads, repository links, metadata, and production hosting.

  • Launched https://www.iccjk.com as the official public domain.
  • Aligned branding to imux across title, metadata, footer, download links, and repository links.
  • Connected the website to the public GitHub release path for the macOS build.
March 25, 2026

First public imux product baseline

v0.0.1

The initial public line centered the workflow around a native macOS command center with terminal-first execution and surrounding control surfaces.

  • Terminal-first workspace model.
  • Local and remote explorers with SSH-backed remote browsing.
  • In-workspace file viewing and editing plus source control visibility.
  • Supervisor-oriented execution flow for task framing and multi-step work.
Upgrade guidance
Read the latest changelog entry before installing a new build.
Replace the app from the latest DMG instead of mixing partial app copies.
Recheck LLM settings, saved SSH behavior, and workspace assumptions after upgrading.
Validate one local workspace and one remote workspace before moving critical work onto the updated build.
If an upgrade changes expected behavior

When something feels off after updating, use the guide to re-check the intended workflow, compare against the releases feed, and report a concrete issue with paths, settings, and reproduction steps.

What to include in a useful issue report
The imux version and whether the issue is local, remote, or supervisor-related.
The workspace path or SSH target involved.
Expected behavior versus actual behavior.
A short sequence of clicks, commands, or prompts that reproduces it.
A screenshot or terminal output when the problem is visual, remote, or stateful.
Platform status

macOS is the only production desktop build today. imux currently ships as a native AppKit/SwiftUI client, so a Windows installer is not published yet.

imux
imux
Centre de commande IA · centre multi-agent terminal-first

Natifs Swift et AppKit. Rendu de qualité Ghostty. Contexte local et distant, opérations sur les fichiers, exécution du navigateur, contrôle des sources et supervision dans un seul espace de travail axé sur l'opérateur.

© 2026 imux. Un cockpit pour l'exécution du AI en premier terminal.

www.iccjk.com