Skip to content

maddada/Ghostex

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,448 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

og

GitHub Releases Discord Website

Ghostex

macOS Native Ghostty-based desktop app (Not using Electron or Tauri!) for running agent CLIs with persistent terminals, GUI panes, browser panes, notifications, mobile access, and a lightweight code editor.

Ghostex is built for developers who keep multiple agents and terminals alive at once. It combines low-RAM Ghostty terminals, native Swift UI, T3code GUI panes, Chromium CEF browser panes, and Android/iOS session access in one workspace.

Looking for contributors. Join the Discord if you want to help: https://discord.gg/df7b3G92CS

Install

macOS

The Homebrew cask installs the correct Apple Silicon or Intel Mac build automatically.

brew trust maddada/tap && brew install --cask maddada/tap/ghostex

You can also download the latest DMG from GitHub Releases.

Windows and Linux ports need contributors.

Android and iOS

Use the mobile apps to connect live to your Ghostex agent CLI sessions.
APKs are in Github Releases. Join discord for iOS app testflight.

Click the button to get the app:

Download Android APK iPhone App Discord

Gallery

Embedded VS Code based editor

Loads on demand for working with markdown, reviewing code, and checking PRs.
Supports all extensions. Sleeps when not in use to same resources (configurable).

image

Split your terminals and use keyboard hotkeys to jump between them in the Agents view

Exact same hotkeys flow that you're used to from terminals like Ghostty & Cmux. Full configurable.
cmd + t for new terminal, cmd + d to split, cmd + option + arrows to switch around, etc.

image

Supports all of the popular Agent CLIs

Ghostex works with Claude Code, Codex CLI, OpenCode, Pi Agent, Gemini, and all other Agent CLIs.
Also supports T3code GUI panes if you prefer those (feature is fully hibernated when not used)

Ghostex T3code panes and supported terminal CLIs

Embedded Chromium Browser

Comes with Annotations, Chrome Devtools MCP for Agents, Profiles.
/ghostex-browser-use to let the agent control your browser tabs without an approval prompt!

image

Rich Prompt Editor with Ctrl+G

Edit your agent prompts with full hotkeys support and image previews!
No more uneditable "[Pasted 50+ lines]" text! Press F1 for all commands.

2026-06-23_CleanShot_15-47-56

Kanban board based on beads!

Put all your thoughts here then let an orchestrator agent manage subagents to tackle them
(Ghostex supports cross Agent CLI orchestration, your Claude Code can launch and steer Codex agents!)

image

Docs view for working with HTML/MD/Excalidraw!

Collaborate with your agent on HTML prototypes, mockups, and explainers! Annotations system included!

2026-06-30_Ghostex_04-58-31@2x

Full markdown editor + annotations that you can send to your agent to collaborate!

2026-06-30_Ghostex_10-03-18@2x

Or even ask the Agent to draw an .excalidraw UI or diagram in the /docs folder:

2026-06-30_Ghostex_03-11-59@2x

Search Previous Sessions from All Agent CLIs in 1 place

Fuzzy search in all your previous sessions accross agents by typing a few words from your prompts Press enter to resume that session! Lots of filters available. Start it from the sidebar or run ghostex find / gx f to start it

image

Also see list of all previous sessions from all agents by title/tag/last active so you can resume any of them

2026-06-30_Ghostex_10-53-36@2x

Extensible Architecture (client apps <-> gxserver daemon <-> zmx persistence)

The client/server split allows your to install just the gxserver daemon on any remote machine then control the agents on that machine from any client device

Supported clients: macOS, iOS, Android, TUI (based on herdr)
Supported hosts: macOS and linux (tested on ubuntu x64 and arm64)

Help with Windows & Linux client apps hi.

2026-06-12_Google Chrome_23-43-07@2x

Cross-agent orchestration built in

Agents can launch other agent session using the "ghostex" cli command. You can ask Claude Code to launch Codex sub-agents and send prompts there/read their output. Write your own skills that use the /ghostex-agent-orchestration skill.

image

Notifications and status

Ghostex supports notification sounds, pets, menu bar indicators (running/done agents), and phone app notifications.
See how many agents are running with just a glance at your menu bar. Click to jump to an agent!

2026-06-23_Ghostex_15-37-53@2x Ghostex notification indicator

Highlights

Feature What it gives you
Ghostty terminals Lower RAM use, better battery life, and stable agent CLI sessions.
Native macOS shell Swift UI for performance-sensitive desktop behavior.
T3code GUI panes Graphical panes alongside terminal agents.
Chromium CEF browser Embedded browser panes with DevTools, profiles, and MCP access.
Lightweight code editor VS Code-based editor for Markdown, PR review, files, and git work.
Mobile access Android and iOS apps for checking and controlling live sessions.
TUI mode Use ghostex or gx to attach from another machine.

Comparison

Feature Ghostex Codex app cmux
Open source Yes - Yes
Ghostty terminal Yes - Yes
Chromium Browser Yes Yes No
Fully featured IDE Yes - -
Built-in Computer use Yes Yes -
Built-in Browser use Yes Yes Yes
Use any model Yes - Yes
Cross Model Orchestration Yes - Yes
Rich Prompt Editor Yes N/A -
iOS & Android Yes Yes -
Pets Yes Yes -
Appshots Yes Yes -
Automations Soon™ Yes -

Main Features

  • First-launch preferences for common install defaults.
  • Git workflows with Sync with Main, split Git menus, prompt-agent PR review, and persistent running toasts.
  • First-prompt title generation for auto-naming new agent sessions.
  • Pinned sessions and assigning tags to sessions.
  • Auto-sleep for unused terminal, browser, and project panes.
  • Live Android and iOS access to agent CLI sessions.
  • SSH continuation with zmx, tmux, and zellij persistence.
  • Rich prompt editor with image insert and preview support.
  • Auto session naming for popular agents.
  • App restart resumes existing agent CLI sessions.
  • Menu bar working/done indicators and notification sounds for most agent CLIs.
  • Multi-pane and multi-group project layouts.
  • Scheduled messages and automation through the Ghostex CLI.

Useful Extras

  • Install gxserver daemon on remote. Connect over SSH in settings. Remote machines show in sidebar.
  • Create worktrees and merge them back easily.
  • Find previous threads by keyword and continue with context.
  • Sync session titles and status into the UI.
  • Run multiple panes and multiple groups per project with split and tab layouts.

Contributing

Ghostex is moving quickly, and help is welcome on platform ports, missing agent CLI integrations, docs, testing, and feature polish.

Join the Discord: https://discord.gg/df7b3G92CS

Credits

Ghostex builds on open source work from these projects and communities:

About

Native Agent CLIs manager for macOS. Ghostty Terminals + Codex App Features/UX = Ghostex! Embedded browser & IDE. Strong agents support.

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

 
 
 

Contributors