gh0st

Download gh0st

Download the verified macOS Apple Silicon release, or build the CLI and browser UI from source.

Early release candidate: the macOS client is a native shell. Settings/API-key entry, native encrypted persistence, biometric unlock, and auto-lock are not wired yet; use the CLI for the current encrypted workflow.

v1.0.0-rc.1 available

macOS (Apple Silicon)

macOS 13+, Apple Silicon (M1/M2/M3)

  • Native Tauri shell
  • DMG installer (3.3 MB) with SHA-256 checksums
  • Global shortcut (⌘⇧G)
  • Menu bar & system tray
  • Local conversation UI
  • xAI Responses API integration
  • File picker integration
  • Window hide/show controls

Build from Source

git clone https://github.com/M4G3LL4N0/gh0st.git
cd gh0st
pnpm install
pnpm mac:build
pnpm mac:dmg
Download DMG
Available now

CLI (Cross-platform)

Node.js 20+, pnpm 9+

  • 12 commands (chat, ask, web, zdr, ...)
  • File-based encrypted storage
  • Interactive chat with Markdown
  • One-shot questions
  • Local web UI server
  • ZDR verification
  • Agent management
  • Encrypted backup/restore

Build from Source

git clone https://github.com/M4G3LL4N0/gh0st.git
cd gh0st
pnpm install
pnpm build:cli
./apps/cli/dist/cli.js --help
CLI Documentation
Via CLI

Browser (Local)

Node.js 20+, any modern browser

  • Full chat interface through the local gh0st web server
  • Streaming responses
  • File drag & drop
  • Agent selector & tools
  • Privacy Inspector
  • Local browser UI foundation
  • Dark/Light mode
  • Responsive design

Build from Source

git clone https://github.com/M4G3LL4N0/gh0st.git
cd gh0st
pnpm install
pnpm build:client
gh0st web
Browser Guide
In development

iOS

iOS 16+, Xcode 15+, Apple Developer Program (device)

  • Safe areas & Dynamic Island
  • Keyboard avoidance
  • Touch targets & gestures
  • Dark/Light & reduced motion
  • Background privacy blur
  • Planned encrypted local vault
  • Planned biometric unlock
  • Simulator build pending tooling

Build from Source

Requires: Homebrew, xcodegen, cocoapods
cd apps/client/src-tauri
cargo tauri ios init
pnpm ios:build
pnpm ios:dev
iOS Status

Verify Your Download

SHA-256 Checksum Verification

  1. 1Download gh0st_1.0.0-rc.1_aarch64.dmg from GitHub Releases
  2. 2Run: shasum -a 256 gh0st_1.0.0-rc.1_aarch64.dmg
  3. 3Compare with SHA256SUMS.txt from the release. Expected SHA-256: cc6e9cb35d6b6908e4791fe3b815c0355487dd3d70c25c3f898250e46491cb19
  4. 4Verify the ad-hoc signature: codesign --verify --deep --strict gh0st.app

Note: This build is ad-hoc signed (identity "-") and is not notarized. macOS may require approval in Privacy & Security on first launch. Developer ID signing and notarization require Apple Developer Program enrollment. The native client’s encrypted vault, biometric unlock, auto-lock, and Settings/API-key entry are not wired in this release candidate.

Release Information

Latest Release

v1.0.0-rc.1

Public prerelease · Apple Silicon

Download DMGView release details

Changelog

See what's new in each version

View Changelog

Source Code

MIT licensed, build yourself

Ready to get started?

Download the public macOS prerelease, or clone the repo to build the CLI and browser UI from source.

Getting Started Guide