Ghost Engineer

Ghost Engineer

Understand any repository before you change it.

A Unix-first CLI that reconstructs repository intelligence locally, writes a `.ghost/` workspace, and sends structured context to IBM Bob only when you ask for AI reasoning.

Download install.sh

Powered by IBM Bob for optional reasoning. Deterministic analysis works locally without Bob.

Ghost Engineer icon

First run

Install once. Run anywhere.
quickstart.sh 
curl -fsSL https://ghost-engineer.dev/install.sh | bash
cd any-repository
ghost analyze .
Ghost Engineer analyzed any-repository
Workspace created: .ghost/
Start here: .ghost/project-summary.md
Writes local intelligence
  • .ghost/architecture.json
  • .ghost/dependency-map.json
  • .ghost/project-summary.md
Install once Global `ghost` command
Run anywhere Open any repository
Bob optional AI reasoning on demand

Workflow

From install to repository context.

01

Install once

Global CLI, available from any repository.

curl -fsSL https://ghost-engineer.dev/install.sh | bash
02

Run anywhere

Open a codebase and scan it locally.

cd any-repository
ghost analyze .
03

Understand first

Get architecture, dependencies, and summaries.

.ghost/
├── architecture.json
├── dependency-map.json
└── project-summary.md
04

Ask Bob when useful

Optional AI reasoning on top of local context.

ghost explain
ghost analyze . --bob # optional

Install path

Install

Global installs the CLI for any repository. Source is for local development from this repo.

Install once and use `ghost` from any repository. 
curl -fsSL https://ghost-engineer.dev/install.sh | bash
ghost analyze .
ghost explain
ghost analyze . --bob
Clone the repo and link the CLI for development. 
git clone https://github.com/deepdevjose/ghost-engineer.git
cd ghost-engineer
npm install
npm run build
cd apps/cli
npm link
cd ../..
ghost analyze .

Environment

System check

Platform
Checking...
Shell
Unix shell recommended
Bob CLI
Optional for local analysis

Local workspace

What `.ghost/` gives you.

.ghost/
├── architecture.json
├── dependency-map.json
├── project-summary.md
├── bob-analysis.md
├── docs/
│   ├── onboarding.md
│   └── test-plan.md
├── reports/
│   ├── initial-analysis.md
│   └── final-report.md
├── patches/
└── bob/
01

Architecture

Structure, scripts, packages, entry points, language mix, and framework signals.

02

Local context

Human-readable summaries and reports before any AI reasoning is required.

03

Bob reasoning

Prompt and response artifacts when you choose to send structured context to IBM Bob.