Ghostex 4.10.0

Changes

• Native workspace panes are better integrated with the macOS host, reducing click-routing misses.
• Direct project-tab titlebars, app modal windows, and toast routing are better integrated with the macOS host, reducing titlebar/sidebar focus churn.
• Passive sidebar terminal restore preserves split layouts while the sidebar catches up.
• Workspace-pane materialization preserves restored split layouts instead of merging panes while the sidebar catches up.
• Project Board focus is steadier during passive refreshes.
• GitHub mode focus is steadier during passive refreshes.
• Directly mounted project tab titlebars route clicks to the intended workspace surface.
• Worktree deletion can clean up related branch metadata from the UI.
• Prompt-editor capability routing reduces stale agent attention after dismissed work.
• Terminal Escape reporting reduces stale agent attention after dismissed work.
• The titlebar adds a compact sidebar collapse button beside the project name.
• Empty Tips unread sections stay hidden.
• Resources recovery is clearer with Restart plus Reload App when gxserver is off.
• Add Worktree, Git Commit, and other native child-window modals have tighter macOS sizing and padding.
• Compact dialogs stay compact while commit review gains room on the right diff side.
• The ghostex and gx CLI commands use gxserver session inventory.
• The ghostex and gx CLI commands add a sidebar toggle.
• The ghostex and gx CLI commands install as wrapper commands outside Ghostex.app so macOS policy assessment does not kill direct app-bundled script execution.
• Agent support expands with Kiro CLI.
• Agent support expands with OMP hook sidecars.
• Agent support expands with mobile session status ingestion.
• Agent support expands with Claude bare /rename staging for first-prompt titles.
• Agent support expands with path-based live-process identity repair.
• Agent support expands with a default Accept All mode setting.
• App Shots now stage captured desktop context in the focused or recent live agent session instead of being Codex-only.
• App Shots create the configured default prompt-agent session only when no agent target is available.
• Sidebar and settings polish adds a collapse command and hotkey.
• Sidebar and settings polish adds Copy Session Details.
• Ghostty settings are folded into the main settings sections.
• Agent Hub file contents load only when opened.
• Android, iOS, Electron, TUI, and zehn integrations are refreshed for gxserver status.
• Android, iOS, Electron, TUI, and zehn integrations are refreshed for shared app toasts.
• Android, iOS, Electron, TUI, and zehn integrations are refreshed for status colors.
• Android, iOS, Electron, TUI, and zehn integrations are refreshed for grouped history search.
• iOS refresh indicators stay tied to active refresh requests.
• Packaged macOS runtime validation checks the bundled code-server Node 22 runtime.
• Packaged macOS runtime validation checks ripgrep, T3 Code native helpers, Beads, and source-map pruning.
• Packaged macOS runtime validation no longer executes sealed native modules during validation.

Downloads

• Apple Silicon: ghostex-4.10.0-arm64.dmg
  SHA256: 0e397fe85ca1eff33f36b1ef77555419ab54e5b5d26dc2dfe39def0656578904

Install

brew install --cask maddada/tap/ghostex

Ghostex 4.1.5

Changes

• Installed agent hooks now run through Ghostex-owned bundled runtimes instead of /usr/bin/python3 or user-installed Node interpreters.
• gxserver resume lookup, native sidebar state helpers, and Electron command-pane updates now run through Ghostex-owned bundled runtimes.
• Hook sidecars and command status updates keep working on machines without Python.
• Claude sessions migrated from Ghostex 3.6 can wake more reliably because gxserver repair backfills transcript paths and saved resume commands.
• Wake resolves Claude's real session id before running claude --resume instead of trusting a sidebar title.
• Context-menu Sleep no longer parks a row as sleeping while the zmx provider is still alive.
• Wake and intentional close flows still show immediate sleeping feedback until the host snapshot confirms the same state.
• Project board ticket creation reconciles each project's Beads issue prefix before mutations.
• Local board actions send both project id and project path so gxserver can reject stale URL/id mismatches.
• The sidebar adds a configurable Show less row count.
• The sidebar adds a Close menu visibility setting.
• The sidebar adds remote-session edit entry points for quicker day-to-day session management.
• Chromium-embedded panes support standard zoom in, zoom out, and reset shortcuts from the toolbar.
• Waking zmx sessions no longer replays stale working/attention activity from the pre-sleep snapshot.
• Project and Kanban flows require Ghostex's bundled Beads CLI and ignore unrelated bd binaries already on PATH.
• Future macOS Sparkle, GitHub, and Homebrew releases ship Apple Silicon builds only.

Downloads

• Apple Silicon: ghostex-4.1.5-arm64.dmg
  SHA256: 9970d86abdd3a6201079b50909c7a87b9a847e9f0f3b685f6d2efb20d4f371e4

Install

brew install --cask maddada/tap/ghostex

Ghostex 4.1.0

Changes

• Remote machines can now save SSH passwords in macOS Keychain.
• Remote machines can use saved SSH passwords for SSH, SCP, and tunnel connections without storing raw passwords in settings.
• Remote machines show clearer saved-password state and authentication guidance.
• Agent hook updates now reject cross-wired agent identities.
• Session-state updates now reject cross-wired agent identities.
• Cross-wired identity protection reduces cases where one agent terminal could inherit another row's title, status, completion state, or resume identity.
• Ctrl+G prompt editing returns focus to the correct terminal more reliably.
• Monaco prompt-editor dismissal returns focus to the correct terminal more reliably.
• Prompt-editor focus repair includes sessions launched through gxserver global references.
• Sidebar presentation updates apply smaller live patches for session groups.
• Sidebar presentation updates apply smaller live patches for HUD chrome.
• Smaller sidebar live patches reduce refresh churn and terminal focus steals while sessions are added, removed, reordered, or updated.
• Session context menus hide Copy Resume by default behind an explicit setting.
• Session context menus hide Copy Attach Command by default behind an explicit setting.
• Sleep Below and Close Below now target the rendered rows beneath the clicked card across project groups.
• Remote sections received visual polish for denser daily use.
• Recent Projects search received visual polish for denser daily use.
• Active sidebar search received visual polish for denser daily use.
• Titlebar resource copy received visual polish for denser daily use.
• Command icons, tag menus, drag handles, and sidebar panel spacing received visual polish for denser daily use.
• The Ghostex TUI now uses a neutral gray-blue default theme.
• The Ghostex TUI has clearer Help/Hotkeys and Quit Ghostex labels.
• The Ghostex TUI has broader built-in agent labels so restored desktop sessions are easier to recognize from the terminal switcher.
• Embedded code-server packaging is more reliable across Apple Silicon and Intel builds.
• Embedded code-server packaging includes target-architecture ripgrep materialization.
• Embedded code-server packaging includes authenticated GitHub artifact fetches during release builds.
• The Android download badge now points at the 4.1.0 release APK.

Downloads

• Apple Silicon: ghostex-4.1.0-arm64.dmg
  SHA256: 1bf4f923861a107460803cc64a87cb15ded356a39462c1f6ff962d0d7298a38e
• Intel: ghostex-4.1.0-x86_64.dmg
  SHA256: e011b8852153eb13af8823c87fc3de6e01df709a261dbd7d579b2de861556142

Install

brew install --cask maddada/tap/ghostex

Ghostex 4.0.3

Changes

• Remote session and group clicks now open a local Ghostty terminal that SSH-attaches to the selected remote session with the stable ghostex attach contract.
• Copy Attach Command still copies the SSH command for external terminals.
• Remote attach carrier terminals stay hidden from the local Quick section, so focus and active styling remain on the owning remote machine row.
• Remote machine setup failures now show more actionable stage-specific messages for SSH, install, token, tunnel, streaming, and transport problems instead of raw loopback or WebKit errors.
• gxserver request failures now show more actionable stage-specific messages for SSH, install, token, tunnel, streaming, and transport problems instead of raw loopback or WebKit errors.
• Remote settings are easier to scan with compact saved-machine cards.
• Remote settings include inline Tailscale setup help.
• Remote settings include clearer optional SSH identity-file guidance.
• The Quick section header can launch the selected agent directly.
• The Quick section header uses the same agent picker as project headers.
• New Quick agent chats stay projectless.
• The titlebar now disables GitHub mode when the active project has no GitHub remote.
• The titlebar now disables GitHub and Kanban mode for Quick sessions.
• Embedded code-server editor panes now use Ghostex-owned bundled settings by default.
• Embedded code-server editor panes start with the Dark 2026 theme on new profiles.
• Embedded code-server editor panes keep local VS Code settings as an explicit opt-in.
• Sparkle update checks repeat quietly while Ghostex is running.
• The titlebar update button can appear on first render.
• Update download and extraction progress windows stay hidden while the release notes and relaunch prompts remain available.
• The native sidebar/workarea divider keeps its resize cursor and visible separator aligned during hover and live resizing.
• Installed macOS app bundles are smaller because release packaging prunes duplicate Beads payloads before notarization.
• Installed macOS app bundles are smaller because release packaging prunes wrong-architecture node-pty prebuilds before notarization.
• Installed macOS app bundles are smaller because release packaging prunes T3 Code source maps before notarization.

Downloads

• Apple Silicon: ghostex-4.0.3-arm64.dmg
  SHA256: 844d8d4134a7e2f9919f6d29160264cff5977141fb49a5cdb36a245f462b624a
• Intel: ghostex-4.0.3-x86_64.dmg
  SHA256: af041600d67011fd13ea4925d343ce2f5a1dfbebbd0fa6e9232cdc14c28e72ad

Install

brew install --cask maddada/tap/ghostex

Ghostex 4.0.2

Changes

• Installed macOS builds now package the full embedded code-server runtime.
• Installed macOS builds reuse the embedded code-server Node 22 binary for gxserver.
• Installed macOS builds include the bundled Beads CLI.
• Installed macOS builds validate the packaged runtime during release builds.
• Source tab packaging is more reliable because the embedded VS Code runtime carries its ripgrep helper files.
• Source tab packaging cleans up temporary build metadata after packaging.
• Terminal image paste can convert clipboard images into previewable Markdown links with Cmd+V or Ctrl+V.
• Settings -> Terminal Behavior now includes a Paste previewable images toggle for users who want normal clipboard behavior.
• gxserver presentation updates now carry stable attention event IDs.
• macOS can play completion sounds and notifications once for fresh attention events.
• Completion sounds and notifications do not replay during startup or stream recovery.
• Command-pane completions keep using the action completion sound path.
• Command-pane completions write status updates through per-process temp files.
• Command-pane completions reduce missed completion sounds during concurrent status updates.
• T3 Code runtime startup is coalesced while Project Editor panes are retargeting.
• T3 Code runtime startup reduces duplicate startup probes.
• T3 Code runtime startup reduces layout churn when opening, closing, or switching embedded T3 panes.
• Git agent workflows no longer pin duplicate persistent "running" toasts when the visible agent terminal already shows the workflow progress.
• Ghostex Android auto-scroll now follows new output only from the actual live bottom row.
• Scrolling up even one row keeps history anchored without selecting text first.

Downloads

• Apple Silicon: ghostex-4.0.2-arm64.dmg
  SHA256: a21aea7c23531db21a7edab50f24353f46ccfa5af237122ac28bd660f6f419e7
• Intel: ghostex-4.0.2-x86_64.dmg
  SHA256: c939d5b51523dec4eda8429e58f27d4c96914fd89078105301d5475a355eed3c
• Android: ghostex-android.apk
  SHA256: 9b7836e2e06c973f97136509e00d247bb151304199dec44247b33016a09bb359

Install

brew install --cask maddada/tap/ghostex

Ghostex 4.0.1

Changes

• Upgrades from Ghostex 3.x can now recover missing gxserver project and session rows even when a completed migration marker was already written, including last-resort recovery from the pre-cutover shared-state backup.
• Passive terminal-title and sidebar refreshes no longer steal keyboard focus from the terminal while you are typing, and sidebar session clicks start native focus/layout work before the React sidebar highlight catches up.
• Git commit review is more useful as a workspace: Show All can concatenate changed-file diffs, diff display preferences persist across app restarts, changed files can copy their path from a right-click menu, and the modal opens directly into review content.
• Quick terminal/browser/file containers no longer trigger project-scoped Git status probes or Git error toasts, and worktree project header menus prioritize Copy Path over a redundant Open action.
• Source tab startup in local development now validates the embedded VS Code payload and Git extension native module before opening, showing actionable setup guidance instead of a raw code-server 500 page or delayed Git activation failure.
• Local starts on Apple Silicon build and launch arm64 Ghostex resources even when the invoking shell is running under Rosetta, and stale zmx/zehn artifacts are rebuilt when their Mach-O architecture does not match.
• The titlebar update button stays available until Sparkle confirms the installed app is current, so opening or closing the update dialog no longer hides a still-applicable update.
• Sparkle appcasts generated by the release flow now embed the matching changelog notes so the update dialog can show release details directly.
• Project editor companion switching avoids unnecessary editor host relayout when the editor is already stable, reducing flashes while moving between companion sessions.
• The transparent native sidebar resize strip keeps the left-right resize cursor while hovered or dragged.

Downloads

• Apple Silicon: ghostex-4.0.1-arm64.dmg
  SHA256: 7615ae9aa8b3b6e3fc0bb8d5207cd5c1f6c32911eecdbd001def3e6fe58584c6
• Intel: ghostex-4.0.1-x86_64.dmg
  SHA256: 6c297ed86c4ef9efe839688a0435649dafbad187becac6bbc622b614322e052f

Install

brew install --cask maddada/tap/ghostex

Ghostex 4.0.0

Changes

• Session tags can be applied, displayed on cards, filtered in Active and Previous Sessions, and preserved in manual sidebar order across restore and Previous Sessions.
• Git commit review adds inline changed-file diff inspection so review prompts can inspect file patches without leaving the modal.
• First-prompt title generation is more reliable, including Grok Build support, staged rename handling, guards for skipped or stale generated titles, and retry after cancellation.
• Native T3 Code panes package the managed runtime in installed macOS builds, keep it alive from live pane ownership, resolve the packaged runtime path, and show bundled, development, or missing status in Settings -> Integrations.
• zmx Ctrl+G prompt editing follows the currently attached client capability, keeping desktop Monaco available while SSH, mobile, and TUI attaches use terminal-native gte.
• Cmd+T creates a terminal tab next to the focused tab, Cmd+N opens a browser tab next to the focused tab, and Option+1 through Option+4 switch Agents, Source, GitHub, and Kanban views.
• Closing the active tab in a split pane promotes the adjacent tab in that pane before layout materialization, preserving split layout instead of collapsing unrelated panes.
• Sleep Inactive and Agent Auto Sleep keep terminals with active Delayed Send timers awake until the scheduled send fires, and focused agent sessions are always excluded from Agent Auto Sleep.
• Agent working indicators and session titles are steadier during spinner-heavy Codex, Claude, Cursor, and Pi activity, reducing attention flicker and repeated no-op sidebar refreshes.
• Background sleep, close, and auto-sleep transitions preserve the focused pane/tab instead of pulling focus away from the active session.
• Agent hook installation covers supported CLIs through gxserver, and installed hooks can report working, attention, idle, first-prompt, and resume metadata directly to gxserver for more reliable status across clients.
• Duplicate completion sounds and macOS notifications are suppressed when the same attention event is replayed from hook or gxserver state.
• Codex-powered title generation, board-title generation, and other internal prompt jobs run as ephemeral/internal work so they do not create restorable Codex sessions or overwrite a real session's resume identity.
• Codex resume validates exact ids and falls back through filtered title lookup, avoiding internal codex exec title-generation transcripts.
• Agent Auto Sleep waits when zmx title-observer health is starting, retrying, or failed instead of treating unavailable working-status detection as idle.
• Full reload for zmx sessions reloads the clicked session in place instead of creating a duplicate sidebar row, and Ctrl+G prompt editing checks the bundled zmx binary instead of a stale PATH zmx.
• New projects and embedded editor panes appear in the sidebar earlier, and code-server startup failures surface as row errors and toasts instead of failing silently.
• Installed macOS builds validate the packaged gxserver Node 22 native-module runtime and show actionable reinstall or Node setup guidance when the runtime does not match.
• Installed macOS builds bundle ghostex and gx CLI binaries with session display-title support and packaged runtime roots.
• Previous Sessions hides command-pane runs, ranks rows by true last activity, and restores durable session tags, restored-from identity, and saved manual sidebar order.
• Sidebar Last Active labels keep ticking from the client clock even when React Compiler caches the row render.
• gx find / zehn history results are grouped by last-active day, show source session titles above matched prompt text, include compact last-active times, and stay quiet unless the user explicitly runs zehn update.
• Provider session ids in terminal panes are hidden by default and remain available through the explicit session-id overlay setting.
• Native terminal Cmd+C uses Ghostty's copy action so selected terminal text reaches the system clipboard consistently.
• Native workspace focus, pane-tab close button chrome, centered sidebar context menus, and visible-row Cmd+number shortcuts are tighter across nightly sidebar interactions.
• Rename Session > Generate Name keeps the visible "Generating title" overlay active until the generated rename is applied or submitted.
• Clone & Add can be submitted as soon as locally valid repository and destination fields are present, while existing-destination previews still block cloning.
• Delayed Send timers keep the leading clock visible over tags and deadline-only projections, and native terminal badges relayout immediately when timers start or cancel.
• Sleep and close actions for presentation-backed zmx sessions use gxserver provider transitions even when older local session metadata is incomplete.
• Ghostex-launched app, gxserver, zmx, agent-hook, Git, Beads, clone, and local dev subprocesses keep ANSI color capability even when the parent shell exports NO_COLOR.
• Native sidebar web bundles use the React Compiler build path for smoother sidebar interactions.
• Debug logs stay quiet in normal use, rotate before growing too large, and show a titlebar warning while Debug logging and UI is enabled.
• Support diagnostics avoid writing raw title previews, command output previews, session id lists, paths, and stderr snippets while keeping counts and timing useful for troubleshooting.
• Dragging images onto inactive terminal panes accepts drops reliably, and restarting Ghostex no longer relaunches the app when closing an installed build.
• Project board and Tasks flows improve ticket routing, comments, placeholders, and Create & Start handoff behavior.

Downloads

• Apple Silicon: ghostex-4.0.0-arm64.dmg
  SHA256: 6ee413b3cd0e2279a16a1cdd49b015c3d06382c2678833e3aa315dc7bf5de4d1
• Intel: ghostex-4.0.0-x86_64.dmg
  SHA256: d4b1f212775fefd7350ef3ac778b7f6f52969d3de7b41d66206906909bf9967f

Install

brew install --cask maddada/tap/ghostex

Ghostex 3.26.2

Changes

• Native command bridge probes the login shell PATH once at launch so GUI-started agents can find OpenCode, mise, npm, and other tools installed through shell startup files.
• OpenCode integration setup refreshes the session plugin for newer OpenCode event APIs and reports installed when the Ghostex plugin file is present.

Downloads

• Apple Silicon: ghostex-3.26.2-arm64.dmg
  SHA256: a6770d3020ba17db0c46bd48d131e80cffc25681925b4f01e1893c14d899ccfa
• Intel: ghostex-3.26.2-x86_64.dmg
  SHA256: 7bd31b13f8ce8b29b7d99d8a184fcb3fd9f913f778e82faed5714e6c27cd72f0

Install

brew install --cask maddada/tap/ghostex

Ghostex 3.26.1

Changes

• Mobile and remote CLI session commands fall back to persisted sidebar session state when the live Ghostex bridge is unavailable, so Android and other clients no longer show a misleading empty session list.
• Sidebar CLI bridge failures now return clearer JSON errors and more helpful guidance when a stale bridge token or closed socket causes the command to fail.

Install

brew install --cask maddada/tap/ghostex

Ghostex 3.26.0

Changes

• Project board adds a Backlog swim lane before Todo, per-lane + ticket creation, status selects with friendly labels, and more reliable Create & Start that launches the agent session before secondary board refresh work.
• Start Work prompts now ask agents to leave bead comments after each turn and include backlog/in-progress/test/review workflow commands.
• Starting work from the Kanban page focuses the created agent session immediately, matching sidebar session-card behavior.
• Command pane defaults restore to 125px (up from the prior smaller default), can grow up to 90% of the workspace height, and native Beads updates accept the backlog status.
• Dropdowns, selects, popovers, and tooltips share the same visible border as sidebar tooltips.
• Titlebar Tips & Tricks copy was refreshed for pinning sessions and using the Kanban board with agents.

Downloads

• Apple Silicon: ghostex-3.26.0-arm64.dmg
  SHA256: 44bc4517db469598799225d8e266c63353dcd9fabe688c36cf06b2c58818c4b9
• Intel: ghostex-3.26.0-x86_64.dmg
  SHA256: 4341b3b2d348a21c314af0b7822d82393085faac25255ad8bc9ffa3c0d43bd23

Install

brew install --cask maddada/tap/ghostex