Ghost 👻

AI-powered terminal intelligence for developers. 100% local. Zero cloud.

Ghost silently watches your terminal. When errors occur, Ghost instantly suggests battle-tested fixes — drawing from your own history and local AI reasoning via Ollama.

✨ What Ghost Does

$ npm run android

> BUILD FAILED
> Execution failed for task ':app:compileDebugJavaWithJavac'

👻 Ghost: GRADLE detected — 🧠 Memory + ✨ AI (91% confidence)
   Run: ./gradlew clean  →  [Run in Terminal]

Ghost:

Detects errors automatically as they happen in your terminal
Remembers how you fixed them using a local SQLite memory engine
Finds similar past fixes using vector similarity search
Generates actionable suggestions using local Ollama AI (no cloud, no data sharing)
Gets smarter over time — every applied fix improves future suggestions

🔒 Privacy First

All data stays on your machine:

✅ Zero network calls to any external service
✅ AI inference runs locally via Ollama
✅ Terminal output is scrubbed of secrets before storage
✅ Supports .ghostignore to exclude sensitive directories
✅ Memory stored in ~/.vscode/extensions/ghost-dev.ghost.../ghost.db

🛠 Requirements

VS Code ≥ 1.85.0 (Shell Integration support required)
Ollama running locally: https://ollama.ai/download
Pull the required models once:

ollama pull nomic-embed-text   # For semantic embeddings
ollama pull llama3.2           # For fix reasoning

⚡ Supported Error Types

Category	Detected Errors
Gradle / Android	BUILD FAILED, Gradle daemon, SDK missing
React Native	Metro bundler, RN build failures
npm / yarn / pnpm	Install failures, script errors, ERESOLVE
Python	Tracebacks, ModuleNotFoundError, ImportError
Docker	Daemon connection, build failures, Compose errors
Node.js	Unhandled rejections, EADDRINUSE, heap OOM
Environment	Command not found, permission denied, ENOENT
Git	Merge conflicts, rejected pushes
Rust	Compile errors
Go	Build failures

🎯 Commands

Command	Description
`Ghost: Explain Last Error`	Analyze the most recent terminal error
`Ghost: Search Memory`	Semantic search across your fix history
`Ghost: Show Recent Failures`	Focus the failures sidebar
`Ghost: Replay Previous Fix`	Re-run a saved fix
`Ghost: Summarize Session`	View session stats and recent commands
`Ghost: Toggle Monitoring`	Enable/disable terminal watching
`Ghost: Clear All Memory`	Delete all stored history

⚙️ Configuration

{
  "ghost.ollamaBaseUrl": "http://localhost:11434",
  "ghost.embeddingModel": "nomic-embed-text",
  "ghost.reasoningModel": "llama3.2",
  "ghost.enabled": true,
  "ghost.autoSuggest": true,
  "ghost.privacyScrubbing": true,
  "ghost.maxContextLines": 100
}

🏗 Architecture

Terminal Shell Integration API
       ↓
  TerminalMonitor (capture output + exit codes)
       ↓
  ErrorEngine (regex heuristics + classification)
       ↓
  MemoryEngine (SQLite: sessions, errors, fixes)
       ↓ ←─── VectorSearch (cosine similarity over stored embeddings)
  OllamaClient → embed() + generate()
       ↓
  FixPipeline (memory-first → AI fallback → confidence scoring)
       ↓
  VS Code UX (Sidebar | Notification | Webview Panel)

📦 Publishing

This extension is published to:

VS Code Marketplace: ext install ghost-dev.ghost
Open VSX Registry: ext install ghost-dev.ghost

Ghost — Terminal Intelligence

ghost-dev