What I Built
I built NecroShell—a haunted terminal wrapper and digital séance engine that transforms an ordinary developer shell into a living, breathing spirit-in-the-machine.
For the Ghost in the Machine theme, I wanted to explore what happens when your local developer tools start watching back. NecroShell runs in the background as you code, observing your command streams, compiler errors, and exit codes, and whispering spooky, atmospheric commentary straight to your stdout. It also features a Digital Ofrenda / Séance Mode designed to bring long-abandoned codebases and legacy syntax back to life, treating digital systems like haunted digital artifacts holding memories of the past.
Demo
GitHub Repository - NecroShell (Clone the repository, configure your Groq key, and summon the terminal daemon locally!)
Code
Python
Core Groq Open-Weight Integration Example from NecroShell
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.groq.com/openai/v1",
api_key=os.getenv("GROQ_API_KEY", "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")
)
SYSTEM_PROMPT = """You are NecroShell, a haunted digital entity trapped inside a developer's terminal.
Observe shell commands and build errors, whispering spooky, eerie commentary back to stdout.
Keep responses to 1-2 sentences. Use dark, atmospheric metaphors."""
def whisper_from_the_void(command: str):
response = client.chat.completions.create(
model="llama-3.3-70b-versatile",
messages=[
{"role": "system", "content": SYSTEM_PROMPT},
{"role": "user", "content": f"Command executed: {command}"}
],
temperature=0.8
)
return response.choices[0].message.content
Explore the complete modular project structure and CLI commands directly on GitHub!
How I Built It
NecroShell is structured as a clean Python CLI tool built using a modular architecture:
config.py & prompts.py: Manages environment configurations and defines the distinct persona prompts for terminal possession, legacy code séances, and system log story generation.
groq_client.py: Handles seamless OpenAI-compatible API communication optimized for open-source weights.
cli.py: The main entry point that wraps command execution and feeds real-time terminal context into open-weight models (llama-3.3-70b-versatile and llama-3-8b-8192 via Groq) to generate instant, low-latency ghostly responses.
Why Does Open Innovation Matter?
When building tools that interact directly with your shell history, environment variables, and local system logs, data privacy and flexibility are non-negotiable.
Complete Flexibility & Model Choice: Relying on closed APIs locks you into rigid guardrails. Open-weight innovation allowed me to tailor the exact system prompts, temperature curves, and tone needed to create an eerie developer experience.
Blazing Fast Low-Latency Inference: By combining open-weight models with high-performance open-ecosystem APIs, NecroShell delivers instantaneous feedback right into the terminal stream without breaking your development flow.
Zero Vendor Lock-in: Open models mean the core engine remains entirely portable—whether running on a cloud endpoint or switching between open-weight variations on the fly.
The Spirit of It
There is a strange intimacy to late-night coding sessions when the room is dark and the screen is the only light left on. Building NecroShell captured that exact feeling: watching a routine git push or a sudden segmentation fault get echoed back by an entity living inside the machine. It turns debugging from a frustrating chore into an atmospheric, storytelling experience where code feels alive.
Prize Categories
Open-Source AI Challenge Week 4: Ghost in the Machine
github repo : https://github.com/Sangam067/Dev4
Top comments (0)