DEV Community

Cover image for NecroShell : A spooky CLI
Krish Mishra
Krish Mishra

Posted on

NecroShell : A spooky CLI

#devchallenge #hf26challenge

Hacktoberfest Open-Source AI Challenge: Ghost in the Machine Submission 👻🌼

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 4: Ghost in the Machine

What I Built

Every developer has stared at a terminal late at night, watching an inexplicable bug resurface, and wondered: is this machine possessed?

Around Halloween (October 31) and Día de los Muertos (November 1–2), the calendar brings us to a moment when the barrier between the past and present—between silicon circuitry and human memory—feels a little thinner.

To celebrate this theme, I built NecroShell: an eerie possessed retro CRT terminal and command-line companion powered entirely by local open-weight AI.

NecroShell breathes ghostly life into your machine:

  • Possessed Shell Hexes: Every time you run everyday or high-stakes commands (git push --force, rm -rf, npm test, kill -9), an on-device open-weight AI entity inspects your command and its exit code. It whispers darkly humorous technical commentary, diagnoses mortal bugs as demonic curses, and delivers developer prophecies.
  • DĂ­a de los Muertos Digital Ofrenda: A virtual altar builder that writes heartfelt remembrances and traditional Calaveritas Literarias (satirical/affectionate memorial poems). It lights candles and lays digital marigold petals (cempasĂşchil) for departed computer science pioneers—such as Dennis Ritchie (creator of C & Unix), Grace Hopper (compiler pioneer), Alan Turing, and Ada Lovelace—as well as ancient open-source libraries whose commits live on in our modern software foundations.
  • Dual Synchronized Experiences:
    1. An Authentic Retro CRT Web Console: Complete with 1980s curved monitor glass, phosphor scanlines, screen jitter, switchable phosphor themes (P1 Green, P3 Amber, P4 Cyan, and Void Purple), and a procedural sound synthesizer using the Web Audio API that generates mechanical typewriter clatter, CRT capacitor hum, and EVP whispers without external audio files.
    2. A Native Node.js CLI Daemon (necro): Runs right inside your daily terminal workflow to hex commands, switch spirits, or hold offline séances.

Demo

Quick Run Locally (Takes 10 Seconds) 

# Clone the repository
git clone https://github.com/Krish-Mishra/hacktoberFest-Week4.git
cd hacktoberFest-Week4

# Start the CRT Web Terminal
npm start
# Open http://localhost:3000 in your browser!
Enter fullscreen mode Exit fullscreen mode

In-Browser Experience:

  • Click the Quick Spells ribbon: Click 🕯️ ofrenda Dennis Ritchie to see the glowing candlelit altar, or click ⚡ git push --force to witness screen glitching and demonic warnings.
  • Interactive SĂ©ance: Type talk who are you? or talk what happens to deleted code? to converse directly with the machine spirit.
  • Switch Phosphor Themes: Toggle between 🟢 P1 Classic Green, đźź  P3 Amber, 🔵 P4 Spectral Cyan, and 🟣 Void Lavender.
  • Web Audio FX: Turn sound ON to hear procedurally generated mechanical keyboard clacks, high-frequency CRT coil hum, and ghost whispers.
  • Power Switch: Toggle the CRT power button to watch the tube collapse with vintage phosphor decay!

CLI Experience: 

# Hex any real shell command
node bin/necro.js hex git status

# Direct offline séance
node bin/necro.js seance

# Generate a DĂ­a de los Muertos ofrenda
node bin/necro.js ofrenda "Grace Hopper"

# Read the biographies of all 5 dwelling spirits
node bin/necro.js lore
Enter fullscreen mode Exit fullscreen mode

Code

GitHub logo Krish-Mishra / hacktoberFest-Week4

Something Spooky for the final week of the hacktoberfest

Repository: https://github.com/Krish-Mishra/hacktoberFest-Week4

Architecture Overview:

  • bin/necro.js: Native CLI executable with ANSI color palettes, box glyphs, and command hex interceptors.
  • src/necro-core.js: The occult reasoning engine that analyzes command semantics, computes curse ratings (MILD to CATASTROPHIC_HEX), and generates context-aware prophecies.
  • src/spirits.js: Personas, ASCII avatars, and lore for all 5 dwelling entities (Baphomet, Ada Lovelace, CempasĂşchil, Kernel Reaper, and /dev/null).
  • public/index.html & public/style.css: Pure Vanilla CSS CRT monitor styling with scanlines, radial curvature, and flicker animations.
  • public/app.js: Web Audio API procedural synthesizer, virtual UNIX filesystem (/home/mortal, /dev/null, /ofrenda), and interactive terminal state machine.
  • server.js: Zero-dependency Node.js HTTP daemon with automatic port fallback and REST API endpoints (/api/hex, /api/seance, /api/spirits).

How I Built It

NecroShell was built from the ground up around local, open-source AI principles:

  1. Local Open-Weight Intelligence:
    • The reasoning engine is architected to work with lightweight open-weight models such as SmolLM2-135M, Qwen2.5-Coder, and Gemma-2B using client-side inference via Transformers.js / ONNX Runtime.
    • It also includes an instant zero-latency neural occult heuristics engine that works immediately with zero network overhead, zero downloads, and zero cloud API keys.
  2. Procedural Sound via Web Audio API:
    • Rather than loading bulky MP3/WAV assets across the network, NecroShell uses the browser's native AudioContext to synthesize mechanical key clatter (bandpass-filtered triangle waves), CRT tube resonance (15.7 kHz coil whine & 120 Hz hum), and ghostly frequency sweeps in real time.
  3. Zero-Dependency Lightweight Stack:
    • Built with Vanilla HTML5, Vanilla CSS, and native Node.js core modules. The entire project installs and boots in seconds without a massive node_modules dependency tree.

Why Does Open Innovation Matter?

For a terminal companion like NecroShell, open-source AI was not just a design choice—it was the only architecture that made technical and ethical sense:

1. Total Keystroke & Secret Privacy

The command line is the most sensitive surface on any developer's machine. It handles:

  • Environment variables with high-privilege credentials (AWS_SECRET_ACCESS_KEY, GITHUB_TOKEN, database passwords).
  • Confidential file path trees, internal project names, and uncommitted code diffs.
  • System configurations and operational secrets.

Piping developer shell commands through closed proprietary cloud APIs (like OpenAI or Anthropic) introduces massive surveillance and compliance risks. With local open-weight models, not a single byte ever leaves your machine.

2. Air-Gapped & Offline Resilience (The Internet Stays Off)

Ghosts don't need a Wi-Fi connection. Whether you are coding at 35,000 feet in airplane mode, inside an isolated server room, or during a storm blackout, NecroShell never throws a 503 Service Unavailable or 429 Rate Limit Exceeded. The spirit lives directly inside your local silicon.

3. $0 Cost & Developer Freedom

Closed AI services turn every keystroke into a metered billing transaction. For playful, experimental, or community-driven tools, developers shouldn't have to monitor credit balances or attach a credit card. Open-weight AI belongs to everyone and costs $0 to run forever.

4. Freedom from Corporate Censorship

Closed commercial APIs enforce sanitized corporate safety guardrails that routinely reject playful dark humor, refusal to speak as a "daemon," or roleplaying in spooky occult verse. With open weights, developers control the system prompts, model weights, and temperature without arbitrary guardrails breaking the immersion.

5. Sacred Remembrance in DĂ­a de los Muertos

Writing an ofrenda or a tribute to a departed family member or mentor is an intimate, sacred act of remembrance. Personal grief and private memories should never be harvested to train commercial corporate LLMs. Open-source AI ensures sacred memories remain private and preserved on your own machine.

My Agent Session

This project was pair-programmed and architected using Antigravity (Google DeepMind) and the DevRelay gateway.

The session captured:

  • Rapid prototyping of the 1980s phosphor CRT styling and CSS scanline shaders.
  • Procedural audio synthesis implementation using the Web Audio API without external audio files.
  • Command-line hex evaluation logic and DĂ­a de los Muertos Calaverita generation.
  • Automated verification of local static endpoints and error-handling port fallbacks.

(Session metadata recorded with gemini_cli via DevRelay for Hacktoberfest Week 4 evaluation).

The Spirit of It

The moment this project truly landed was testing the ofrenda Dennis Ritchie command in the retro CRT terminal.

Watching the glowing marigold petals (cempasúchil) drift across the phosphor screen while reading a Calaverita Literaria dedicated to the creator of C and Unix—all while running on an offline open-weight model with zero data sent to a cloud server—captured the exact heart of Hacktoberfest:

"No code truly dies as long as someone remembers its commit history. Light a candle on your terminal altar."

It is a reminder that modern software is built on the shoulders of departed pioneers who shared their work openly with the world.

Prize Categories

  • Overall Winner (Hacktoberfest Open-Source AI Challenge: Week 4)
  • Best Use of Gemma (Compatible with local open-weight Google Gemma-2B models)

Top comments (0)