⚡ Why ktui?

Tired of memorizing exact YAML structures, indentation rules, and valid fields for every Kubernetes resource?

ktui solves this by giving you a dynamic, schema-driven terminal UI. It behaves like a modern web form inside your terminal. Pick a resource, fill in the fields you care about, use the interactive field picker to search for advanced properties, and preview or save the generated YAML.

✨ Features

• 🏗️ Schema-driven Forms: Built-in definitions for core Kubernetes resources (Deployments, Pods, Services, ConfigMaps, RBAC, OpenShift Routes, etc.).
• 🔍 Interactive Field Picker: Don't see the field you need? Open the searchable field picker to dynamically mount new properties or entire field groups (like spec.template.spec.containers) into your form.
• ♻️ Smart Merging: Added fields are intelligently merged into their correct hierarchical sections—no duplicate categories or broken nesting.
• 🗂️ Multi-Tab Editing: Open several resources at once (even multiple of the same kind), each in its own tab with independent state. Tabs are titled after metadata.name.
• 👁️ Live YAML Preview: Press p at any time to instantly see the clean, formatted YAML you are building.
• 🎨 Modern TUI: Keyboard-first navigation, multiple themes (press t to cycle), and a responsive layout powered by Textual.
• 💾 Instant Save: Save your generated manifests directly to your disk with a single keystroke.

🚀 Installation

ktui is distributed as both a Python package and a self-contained executable via npm.

Option A: npm / npx (Recommended for JS/TS devs)

You don't even need Python installed! The npm package downloads a pre-compiled native binary for your OS (Linux, macOS, Windows).

# Run directly without installing
npx @ktui/editor

# Or install globally
npm install -g @ktui/editor

Option B: pipx / pip (Recommended for Python devs)

Install via PyPI using pipx (to keep your environment clean):

pipx install ktui

# Or with pip
pip install ktui

⌨️ Usage & Keybindings

Simply run ktui in your terminal to start the application.

Global

Field Picker (Press Add Field in forms)

🛠️ Development

If you want to contribute or build from source:

git clone https://github.com/marceleno1717/ktui.git
cd ktui

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install in editable mode with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Start the app
ktui

📄 License

This project is licensed under the PolyForm Noncommercial License 1.0.0.