ShellGeist Logo
ShellGeist TUI - Cyberpunk terminal interface with AI agent

The Ghost in Your Shell

ShellGeist is a transparent, cyberpunk Terminal User Interface (TUI) agent powered by LLMs. It haunts your terminal to help you code, navigate, and automate tasks without ever leaving your keyboard.

Python Textual NixOS AI License

Features

👾 Cyberpunk Dashboard

A grid-based layout inspired by modern IDEs and sci-fi interfaces. 100% transparent — seamlessly blends with your terminal wallpaper or blur.

🧠 Dual Mode Brain

FAST Mode: Uses lightweight models (e.g., Mistral) for instant answers.
SMART Mode: Switches to heavy-hitters (e.g., Llama3, GPT-4) for complex reasoning and planning.

🤖 Autonomous Agent

/auto Planner: Breaks down high-level goals into executable steps.
/edit Coder: Smart file editing with diff previews and safety checks.
/sh Executor: Generates and runs shell commands safely.

📊 Real-time Monitoring

Live CPU/RAM usage tracking. Reactive agent status indicators (IDLE, THINKING, PLANNING, CODING).

Commands

Chat // <msg> Just type to chat with the AI
Auto /auto <goal> Autonomous Mode: Plans and executes complex tasks
Edit /edit <file> <instr> Edit a specific file with instructions
Shell /sh <task> Generate and run shell commands
List /ls List files in the current directory with icons

Other Projects