Ghost Engineer

Understand any repository before you change it.

A Unix-first terminal workbench that reconstructs full-repository context locally, writes a `.ghost/` workspace, and hands that structured intelligence to IBM Bob for codebase-wide reasoning, documentation, test planning, and safe change guidance.

Download install.sh

Deterministic analysis can run without Bob, but the complete Ghost Engineer workflow is Bob-powered. Bob Shell is a separate IBM product, requires Node.js 22.15.0+, and uses IBMid authentication.

Complete path

Open the Workbench. Connect Bob.

quickstart.sh

curl -fsSL https://ghost-engineer.pages.dev/install.sh | bash
ghost
ghost setup bob
cd any-repository
ghost analyze . --bob

Ghost Engineer analyzed any-repository
Workspace created: .ghost/
Bob reasoning written: .ghost/bob/architecture-response.md

Reconstructs context for Bob

.ghost/architecture.json
.ghost/dependency-map.json
.ghost/project-summary.md

Scan locally Deterministic repository map

Reason with Bob Full-context AI workflow

Evolve safely Docs, tests, reports, plans

Workflow

From install to Bob-powered repository context.

Install Ghost Engineer

Global workbench and command mode, available from any repository.

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

Open the Workbench

Use the terminal UI to inspect state, actions, artifacts, and activity.

cd any-repository
ghost

Connect IBM Bob

Check Bob Shell, install it if needed, then sign in with IBMid.

ghost setup bob
curl -fsSL https://bob.ibm.com/download/bobshell.sh | bash

Analyze any repository

Ghost reconstructs local context before Bob receives anything.

cd any-repository
ghost analyze .

Reason with Bob

Use Bob over the structured `.ghost/` context for reports, docs, tests, and safe change guidance.

ghost analyze . --bob
ghost report . --bob

Install path

Install

Global installs Ghost for any repository. Run `ghost` to open the Workbench, then `ghost setup bob` for Bob Shell installation, Node.js 22.15.0+ requirements, and IBMid sign-in.

curl -fsSL https://ghost-engineer.pages.dev/install.sh | bash
ghost
ghost setup bob
ghost analyze .
ghost explain
ghost analyze . --bob

git clone https://github.com/deepdevjose/ghost-engineer.git
cd ghost-engineer
npm install
npm run build
mkdir -p ~/.local/bin
INSTALL_DIR="$(pwd)"
cat > ~/.local/bin/ghost <



        
          Environment
          System check
          
            
              Platform
              Checking...
            
            
              Shell
              Unix shell recommended
            
            
              Bob CLI
              Core for full workflow



      
        
          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 Ghost sends structured context to IBM Bob.