Skip to content

jal-co/Ghostex

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

597 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Discord: https://discord.gg/xYSBPapM

Native Ghostty Based Open Source Alternative to Codex App

Low Ram Use. Longer Battery. All Agent CLIs. T3code. Notifications. Pets.
Light VScode Embed. Embedded Browser. Rich Prompt Editor. Android & iOS Apps.

Looking for contributers! Please join the discord if interested!

ghostex-main

Main Points:

1. Ghostty Terminals for low RAM usage, longer Battery life, great Agent CLIs stability

2. Native swift for all the parts that require it to improve performance and UX

3. T3code for GUI panes

4. Chromium CEF Browser (Devtools & Profiles)

5. Light embedded VS Code (for MD files/Reviewing Code & PRs)

6. Android & iOS apps for connecting to sessions easily

7. TUI mode (ghostex cli) to connect to all your sessions from any other machine.

More Features:

  • Embedded Chromium Browser w Devtools and profiles
  • Embedded Light Code/MD Files Editor
  • Access your sessions with any Agent CLI live from the Android/iOS apps
  • Built in SSH continuation with live session persistence (zmx/tmux/zellij)
  • The best agent CLI rich prompt editor with Image insert/preview support. Press ctrl+g to use it.
  • Native Swift macOS app shell for better performance
  • Auto sleep unused terminals to save ram (auto-restore when clicked)
  • Auto session naming for all popular agents
  • Reopening the app always resumes your agent cli sessions
  • Light embedded VS Code based editor & git manager & managing PRs with github PR extension.
  • Menu bar working & done indicators and notification sounds for almost all agent clis
  • Supports Pets so you can see session status at a glance :)
  • Works with all Agent CLIs (Claude Code, Codex CLI, OpenCode, Pi Agent, Gemini, Copilot, etc.)
  • Schedule sending messages to agents (more automation features coming soon)
  • Way more features to fit here

Installation

(Looking for help with Windows & Linux ports)

macOS (ARM & Intel):

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

brew install --cask maddada/tap/ghostex --force

Or just download the latest dmg from the releases page


Android & iOS apps to Live connect to any Agent CLI sessions remotely

  • Android app APK is in GitHub Releases:

Download Android APK

  • iPhone app is in Test Flight. Click here to join the Discord to get it: iPhone App Discord

74733 74068


2 Rich Prompt Editor Modes! Monaco based & TUI based:

74730

All Agent CLIs supported (please send an issue or PR for integrating any missing agent cli)

Untitled

Includes Chromium based embedded browser with Devtools, profiles, and MCP access:

Ghostex sidebar with terminal and browser panes


Includes embedded VSCode for editing files, checking PRs, and working with git
(loaded on demand)

2026-05-08_CleanShot_18-38-12@2x

Notifications for All Agent CLIs. Menu bar indicator and minimal floating numbers also supported.

2026-05-23_CleanShot_14-26-43

Other useful stuff:

  • Built in zmx/tmux/zellij support
    • Can continue via ssh then use ghostex or gx cli to attach.
  • Automations and cross agent messages through Ghostex CLI
  • Create worktrees and merge them back easily
  • Prompt to find any past thread in your history with just a few keywords
    • Very useful if you want to continue with an agent that already has context about a complex feature
  • Auto sync the session's title and status with UI
  • Allows multiple panes and multiple groups per project, each with different split/tab layouts
  • Can be attached to your IDE: Shows a button on the attached IDE (Zed / VScode) to show Ghostex.
    • Follows your IDE size/position.
    • Project in IDE & Ghostex is mirrored.
    • Hotkey to hide/show.
    • Click on your IDE to hide Ghostex
  • Can also integrate with Chrome Canary as the default agentic browser (positions it inside Ghostex and adds it to the sidebar)
    • MCP setting to make Chrome Canary always used by your agent:
    1. Ask the agent to use "Chrome Devtools MCP"
    2. Enable remote debugging on Chrome Canary
    3. Set your mcp to use canary channel:
For Claude Code:

~/.claude.json

{
  ...
  "mcpServers": {
    "chrome-devtools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "chrome-devtools-mcp@latest",
        "--channel=canary",
        "--autoConnect"
      ],
      "env": {}
    },
    ...
  },
  ...
For Codex:

~/.codex/config.toml

[mcp_servers.chrome-devtools]
command = "npx"
enabled = true
args = [ "chrome-devtools-mcp@latest", "--auto-connect", "--channel=canary" ]

About

Native Agent CLIs manager for macOS. Ghostty + Codex app = Ghostex! Embedded browser. Strong agents support.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Zig 53.3%
  • TypeScript 19.1%
  • Swift 16.6%
  • C 2.9%
  • CSS 2.5%
  • C++ 2.0%
  • Other 3.6%