DEV Community

Cover image for Lumina: A Minimalist Python Shell Wrapper with Ghost Text Suggestions
tahSin
tahSin

Posted on

Lumina: A Minimalist Python Shell Wrapper with Ghost Text Suggestions

I built a simple tool called Lumina to solve a personal annoyance: I wanted Fish-style command suggestions in my terminal without switching my entire shell environment or dealing with heavy configurations.

What it does

Lumina acts as a wrapper for your existing shell. It records your command history into a local JSON file and provides inline ghost text suggestions based on that history as you type.

Key Features

  • History-based Autocomplete: Suggestions are pulled directly from your persistent JSON storage.
  • Built-in Validation: If you try to run a command that doesn't exist, it lets you know (with a bit of personality).
  • Lightweight: Built with Python and prompt_toolkit.
  • Portable: Easy to install and runs on top of your current system shell.

I originally built this just for my own workflow, but I’ve open-sourced it in case anyone else finds it useful or wants to build upon it.

Check out the repo here: https://github.com/tahsinzidane/lumina

Invalid command = Instant Aura loss

Top comments (0)