👻 GhostShell — The Terminal That Remembers

A developer built GhostShell, an open-source, local-first AI terminal assistant that runs a local Gemma 3 1B model to analyze coding activity, Git history, and syntax errors and respond with in-character commentary from a fictional ghost. The tool includes a Java debugger that caught an infinite-loop bug where the inner loop incremented the outer variable, plus Git memory commands, persistent local storage under ~/.ghostshell/, and a sandboxed design that disables command execution. It is released under the MIT License.

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 4: Ghost in the Machine https://dev.to/challenges/hacktoberfest-week4-2026-10-26 GhostShell — The Terminal That Remembers is a spooky, local-first AI developer assistant engineered for the terminal. Dwelling directly inside the developer's machine, GhostShell observes coding activity, Git history, and syntax errors, translating them into eerie, witty, and razor-sharp commentary from a fictional ghost trapped within the silicon. .-"-. / \ / | | | | / || | | | | | | | | | | | | \ \| | | | | \ ^ / | | | | ' \ / \/ | | | ' \ / \ | | ||||| | | | | | | | \ \ | | /| | | | / | | '-----' \ | | | |\ /| /\ | | | | |\ | | | ⚡ GHOST IN THE MACHINE • LOCAL-FIRST AI COMPANION • v1.0 MASTER ⚡ In classic philosophy and sci-fi lore, the "Ghost in the Machine" refers to consciousness arising unexpectedly from mechanical hardware. We asked ourselves: What if the ghost inside your computer wasn't just a metaphor, but an active, intelligent terminal presence that watches your commits, remembers your debugging struggles, and speaks to you from the phosphor glow of your screen? Instead of building another generic chatbot wrapper or browser tab, we built an authentic, retro-futuristic terminal companion with dark phosphor CRT styling, green phosphor glow, and deep local-first intelligence. 👻 Possessed Java Debugger /debug : :done / :cancel controls. for int col = 1; col <= row; row++ , where the inner loop increments the outer variable. 📜 Machine Memory & Git Intelligence /git , /story , /review : shell=False . /git : Summarizes the most recent commit records from repository memory. /story : Weaves an eerie gothic tale grounded strictly in real commit hashes, authors, and log messages. /review : Provides a cautious high-level development velocity and commit hygiene review. 🧠 Private Local Memory /history , /forget , /storage : ~/.ghostshell/ . os.replace prevent corruption during sudden power loss or terminal closure. /forget . 🎭 Ghost Personality Matrix /persona , /theme : green classic CRT glow , amber retro amber , cyan spectral ice , and monochrome . 🛡️ Sandboxed Safety Containment: False ALLOW COMMAND EXECUTION = False . GhostShell never executes user or AI commands. localhost . Watch the high-definition video walkthrough - https://drive.google.com/file/d/1GFKkGP5ax4ZlsgfAtlk2a7bogAqHSmQv/view?usp=sharing https://drive.google.com/file/d/1GFKkGP5ax4ZlsgfAtlk2a7bogAqHSmQv/view?usp=sharing Experience GhostShell running live in Windows PowerShell with local Gemma 3 1B: When submitted the notorious loop bug: for int row = 1; row <= 5; row++ { for int col = 1; col <= row; row++ { System.out.print " " ; } System.out.println ; } GhostShell renders 5 distinct spectral panels: row++ increments the outer loop variable instead of col++ , causing col to remain constant at 1 and creating an infinite loop. javac and java commands to verify the fixed pyramid pattern. ghostshell@machine:~› /git Renders a structured table of recent commits with short hashes, relative times, authors, and commit messages. ghostshell@machine:~› /story The ghost analyzes recent commit history and composes a gothic narrative about the rituals inscribed into the silicon. A complete 10-step evaluator demo guide is included in DEMO.md https://github.com/RudraBhullar/GhostShell/blob/main/DEMO.md . GhostShell is 100% open-source under the permissive MIT License. GhostShell/ ├── main.py Entry point, argument parsing & interactive REPL loop ├── requirements.txt Lightweight dependencies Rich, Pytest ├── LICENSE MIT License ├── README.md Comprehensive documentation & setup guide ├── CONTRIBUTING.md Developer guidelines & security invariants ├── DEMO.md Step-by-step presentation script ├── SUBMISSION.md Challenge submission post │ ├── ghostshell/ Core GhostShell package │ ├── init .py Exports & version metadata v1.0.0 │ ├── client.py Lightweight HTTP client for local llama.cpp endpoint │ ├── config.py Themes, model endpoints, and security invariants │ ├── ui.py Rich terminal UI, ASCII banners, panels, spinner & syntax │ ├── commands.py Slash command registry /help, /debug, /git, /persona... │ ├── debugger.py Possessed Java Debugger & 5-section parser │ ├── git intel.py Phase 4 Git Intelligence read-only subprocess │ ├── memory.py Phase 5 Private Local Memory atomic JSON store │ ├── persona.py Phase 6 Ghost Personality Engine & Theme Palettes │ └── engine.py Response engines GemmaEngine & PlaceholderEngine │ └── tests/ Automated test suite 115 passing tests gemma-3-1b-it-Q4 K M.gguf , ~1.0 GB disk footprint, ~1.8 GB active RAM. llama.cpp server llama-server.exe exposing an OpenAI-compatible endpoint at http://127.0.0.1:9931/v1/chat/completions . -ngl 0 , requiring no dedicated GPU and zero cloud API keys . urllib.request in ghostshell/client.py ctypes.windll.kernel32 to ensure proper ANSI/VT100 escape sequence handling, preventing cursor drift and layout corruption when moving or resizing PowerShell windows. PersonaEngine llama-server is stopped or times out, GhostShell provides heuristic pattern checks and grounded Git summaries without crashing. Open innovation and open-weight models like Google Gemma make tools like GhostShell possible in ways closed cloud APIs never could: Protecting Proprietary Code and Context: Developers paste proprietary code snippets, compiler logs, and private Git histories into their developer assistants every day. Cloud-based APIs send this sensitive intellectual property to remote data centers, risking logging, vendor data leaks, and compliance violations. With local Gemma inference, all computation remains on-device—zero bytes leave localhost . Independence from Paywalls & Remote Rate Limits: Closed APIs introduce billing meters, API quotas, and network latency. An open-weight model running on consumer CPU means that any student, indie developer, or open-source contributor can have an AI assistant that never expires, never sends a monthly bill, and works in an airplane cabin without WiFi. Democratization on Everyday Hardware: Gemma 3 1B in Q4 K M quantization demonstrates that you don't need a multi-thousand-dollar GPU cluster to build intelligent developer tooling. With under 2 GB of RAM, a standard laptop becomes a capable Java debugger and Git analyst. Freedom to Customize Without Black-Box Filters: Open-weight models allow developers to inspect, modify, and compose system prompts freely. We were able to craft an intricate gothic personality system without fighting opaque cloud guardrails that reject stylistic immersion. This project was built with agentic AI pair programming using Google DeepMind's Antigravity system. To embed the interactive session transcript, use the DevRelay Liquid tag: {% devrelay 2042f6e8-76a0-4c92-b21a-600bf26719b0 %} Or view the persistent session transcript log recorded at: .gemini/antigravity/brain/2042f6e8-76a0-4c92-b21a-600bf26719b0/.system generated/logs/transcript.jsonl There is an unforgettable moment when software crosses the threshold from functional tool to immersive artifact. During late-night testing of Phase 3, we pasted a broken Java pattern-printing method that had plagued thousands of introductory computer science students—the dreaded for int col = 1; col <= row; row++ . In response, the terminal flickered in phosphor green, and the local Gemma model produced this single sentence: "The loop drinks the row's lifeblood, spinning endlessly into the void..." Beneath that chilling line lay a surgically accurate explanation of why the inner loop incremented the wrong variable, complete with corrected Java code and javac verification commands. In that moment, GhostShell landed. It wasn't just another linter or generic code generator; it felt like a ghost had taken up residence in the silicon, guiding the mortal coder through the dark labyrinth of compiler errors. Use Gemma, Google's open-weight model, in building your project: run it locally, fine-tune it, or serve it through Google Cloud or another provider. Why GhostShell qualifies: archivist , poltergeist , grim-debugger without degrading technical precision.