kiss-editor 0.1.1

KISS — keep it simple, stupid.

A small terminal editor built with Textual. It opens files and folders, with syntax highlighting, a file tree and undo/redo. Just an editor — no LSP, no plugins, no ambitions to become an IDE.

About

Status

KISS is early-stage software. It's not a replacement for nano or vim — just a small editor that tries to stay simple and useful. Some things are still missing (see TODO).

Install

via package managers:

[uv tool / pipx] install kiss-editor

or from source (requires Python 3.12+ and uv):

git clone https://github.com/levk-m/kiss.git
cd kiss
uv sync
uv run kiss

Or run directly without cloning:

uvx kiss-editor

Usage

kiss <file>         Edit a file
kiss <dir>          Browse a directory
kiss .              Open current directory

Features

• File tree — browse and open files from the sidebar
• Syntax highlighting — auto-detected, Dracula by default
• Command palette (Ctrl+P) — fuzzy-find files, switch themes
• Undo / Redo — Ctrl+Z / Ctrl+Y
• Clipboard — cut, copy, paste (Ctrl+X/C/V)
• Line numbers, word wrap, cursor line highlight
• Config — ~/.kiss_conf.json, open with Ctrl+O
• Help dialog — Ctrl+H
• Splash screen — pyfiglet logo on startup
• Status bar — shows filename, unsaved changes (*), focus mode

Keybindings

Navigation

Selection

Editing

Interface

Configuration

JSON config file at ~/.kiss_conf.json. Open it with Ctrl+O — changes take effect after restart. A copyable example lives at examples/kiss_conf.json.

{
    "kiss": {
        "theme": "tokyo-night",
        "editor-theme": "dracula",
        "show_line_numbers": true,
        "soft_wrap": true,
        "highlight_cursor_line": false,
        "start-screen": false
    }
}

Application themes

textual-dark, textual-light, nord, gruvbox, catppuccin-mocha, catppuccin-latte, catppuccin-frappe, catppuccin-macchiato, dracula, tokyo-night, monokai, flexoki, solarized-light, solarized-dark, rose-pine, rose-pine-moon, rose-pine-dawn, atom-one-dark, atom-one-light, ansi-dark, ansi-light

Editor themes

css, monokai, dracula, vscode_dark, github_light

css is the default editor theme. It has no fixed background — it adapts to the current application theme's palette, so the editor blends with the app UI.

TODO

• Enter handling — auto-indent to match the current line on newline
• Custom command palette — replace the default Textual palette with a bespoke one

License

MIT License.

Repo: github.com/levk-m/kiss