Ghostex  by maddada

AI agent CLI manager for macOS

Created 1 month ago
457 stars

Top 65.4% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> Ghostex is a native macOS desktop application designed for developers managing multiple agent CLIs. It integrates low-RAM Ghostty terminals, Swift UI, GUI panes, an embedded browser, and a VS Code-based editor, offering a unified workspace for agent development and session management with mobile access.

How It Works

Ghostex leverages a native macOS architecture, avoiding Electron or Tauri, to provide a performant desktop experience. It combines Ghostty terminals for reduced RAM usage and better battery life with native Swift UI for desktop behaviors. The application features T3code GUI panes for graphical interfaces alongside terminal agents, an embedded Chromium CEF browser with DevTools, and a VS Code-based editor for code and Git workflows. This approach aims to offer a stable, efficient, and feature-rich environment for managing complex agent CLI sessions.

Quick Start & Requirements

  • Installation: macOS users can install via Homebrew cask: brew trust maddada/tap && brew install --cask maddada/tap/ghostex --force. Alternatively, download the DMG from GitHub Releases.
  • Platform Support: Native macOS (Apple Silicon/Intel). Windows and Linux ports are under development and require contributors.
  • Mobile Access: Android APKs are available in Releases; iOS app details are on Discord.
  • Prerequisites: macOS.

Highlighted Details

  • Ghostty Terminals: Offer lower RAM consumption, improved battery life, and stable agent CLI sessions.
  • Native macOS Shell: Utilizes Swift UI for performance-sensitive desktop interactions.
  • Embedded Chromium CEF Browser: Provides browser panes with DevTools, profiles, and MCP access.
  • Lightweight Code Editor: A VS Code-based editor for Markdown, PR reviews, file edits, and Git operations.
  • Mobile Access: Live Android and iOS apps allow users to connect to and control agent CLI sessions remotely.
  • TUI Mode: Enables attachment to sessions from other machines using ghostex or gx CLI commands.

Maintenance & Community

The project is currently focused on bug fixes, performance improvements, polish, and refactoring, with new feature development paused. Contributions are actively sought for platform ports, agent integrations, documentation, and testing. A Discord server is available for community engagement and contributions: https://discord.gg/df7b3G92CS.

Licensing & Compatibility

The README does not explicitly state a software license. It mentions building upon various open-source projects (CEF Project, T3 Code, VS Code, etc.). Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

Windows and Linux ports are not yet available and depend on community contributions. New feature development is temporarily halted to prioritize stability and bug fixes.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
15
Issues (30d)
28
Star History
379 stars in the last 30 days

Explore Similar Projects

Starred by Patrick Kidger Patrick Kidger(Core Contributor to JAX ecosystem), Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), and
7 more.

vibetunnel by amantus-ai

0.3%
5k
Turn any browser into your terminal
Created 1 year ago
Updated 1 week ago
Feedback? Help us improve.