Making Python CLIs Simple Again with Klix

#klix #cli #python #opensource

Most Python CLI tools do not start messy.

They become messy.

You begin with a command or two. Then you add prompts. Then state. Then output formatting. Then navigation. Then lifecycle logic. Then suddenly your “small CLI tool” looks like five different ideas stitched together.

So instead of pretending that’s fine, I built Klix.

Klix is a Python framework for building structured, interactive CLI applications without turning everything into a patchwork of libraries.

Why Klix Exists

CLI development today is fragmented.

You typically end up combining:

a command parser
a prompt/input library
something for formatting
custom state management
and glue code everywhere

It works.

But it doesn’t stay clean.

Klix brings all of that into a single, consistent system so your CLI grows without turning into chaos.

What Klix Gives You

Klix is designed as a command-first framework with built-in structure.

It includes:

Command routing
Typed session state
Prompt-driven interaction
Rich terminal rendering
Middleware & lifecycle events
Layout primitives
UI helpers like forms, tables, and panels

Instead of assembling tools, you build on one framework.

Getting Started

Install Klix:

pip install klix

Create a new app:

klix init my-app
cd my-app
python main.py

Minimal Example

from dataclasses import dataclass
from klix import App

@dataclass
class SessionState:
    name: str = "Guest"

app = App(state=SessionState)

@app.command()
def greet(state: SessionState):
    print(f"Hello, {state.name}!")

if __name__ == "__main__":
    app.run()