Skip to main content

ktui

An interactive terminal UI for building Kubernetes YAML manifests — schema-driven forms, field picker, and live preview.


What it does

ktui is a terminal application that lets you interactively build Kubernetes resource manifests without memorising YAML structure. Pick a resource type, fill in only the fields you need, add optional fields through a searchable picker, and preview or save the generated YAML — all from your terminal.

Key features:

  • Schema-driven forms for common Kubernetes resources (Deployment, Service, ConfigMap, RBAC, …)
  • Searchable field picker with grouped categories — select individual fields or entire groups at once
  • Added fields are intelligently merged into the correct section (no duplicate categories)
  • Live YAML preview
  • Theme switching (t to cycle)
  • Clean keyboard-first navigation

Requirements

  • Python ≥ 3.12
  • A terminal with UTF-8 support (minimum 80×24)
  • Truecolor recommended but not required

Installation

# From source (development)
git clone <repo-url>
cd ktui
python -m venv .venv && source .venv/bin/activate
pip install -e .

# Run
ktui

Keybindings

Key Action
↑ / ↓ Navigate list
Enter Select resource / confirm
p Preview YAML
Ctrl+S Save YAML
t Cycle theme
Esc Close modal / go back
q Quit

Inside Field Picker:

Key Action
↑ / ↓ Navigate fields
Enter on leaf Toggle field selection
Enter on 📁 group Select / deselect all fields in group
Esc Cancel without adding

Status

Early development — schemas and features are actively expanding.


License

PolyForm Noncommercial License 1.0.0

Metadata

Release files for ktui 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ktui 0.1.0
File Size Uploaded
ktui-0.1.0.tar.gz 115.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ktui 0.1.0
File Interpreter ABI Platform
ktui-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 248.3 kB

Release files / ktui-0.1.0.tar.gz

Download URL ktui-0.1.0.tar.gz
Size 115.0 kB
Tags Source
SHA-256 checksum
How to use checksums
cc1f6dc97e42a643fb573a50093a14580fafb412b90b65486f75608805388647
BLAKE2b-256 checksum
How to use checksums
3a83ef8753752a2d9873adbd5f09f9a3a9a450bfe8c99f98cc6dc02a25eebfee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.

Transparency log

Release files / ktui-0.1.0-py3-none-any.whl

Download URL ktui-0.1.0-py3-none-any.whl
Size 133.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ae31a494fa5619fd37ecfc3545457696c957b787b26b74a4b270415b76425f35
BLAKE2b-256 checksum
How to use checksums
55d7ffdc3ea5ffc9e4dff5bb232607be98f918062f838e3790e03820395de267
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.

Transparency log

Release history Release notifications | RSS feed

0.2.1

2 release files

0.2.0

2 release files

0.1.3

2 release files

0.1.2

2 release files

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page