gh0st

Getting Started

Install, configure, and run the gh0st CLI in minutes. Native macOS and browser clients are early in this release candidate.

Prerequisites

ToolVersionRequiredNotesInstall
Node.js20+—Link
pnpm9+—Link
Rust1.75+—Link
Xcode15+For macOS/iOS native buildsLink
xAI API Key—From console.x.aiLink

Quick Start (4 Steps)

1

Clone & Install

git clone https://github.com/M4G3LL4N0/gh0st.git
cd gh0st
pnpm install
2

Bootstrap

./setup.sh
# or: pnpm setup
3

Configure xAI

./apps/cli/dist/cli.js doctor --setup
4

Start Chatting

./apps/cli/dist/cli.js chat

CLI Commands Reference

CommandDescriptionFlags
gh0st chatInteractive chat session--strict, --model, --agent
gh0st ask "..."One-shot question-m, --model, -a, --agent
gh0st webStart local browser UI--port 1420
gh0st zdrVerify ZDR status--force
gh0st statusShow system status--json
gh0st doctorDiagnostics & setup--fix, --setup

Next Steps

CLI Guide

All 12 commands, flags, and workflows

Browser UI

Local web interface guide

macOS App

Native app build & usage