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. It's for learning, and for the moments where a tiny no-nonsense editor is enough. Some things are still missing (see TODO).
Install
for unix systems:
curl -fsSL https://raw.githubusercontent.com/levk-m/kiss/main/install.sh | bash
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
The usual editor essentials are here — undo/redo, clipboard, line numbers, word wrap, cursor line highlight. On top of that KISS adds:
- File tree — browse and open files with custom icons per file type
- Syntax highlighting — auto-detected from the file
- Go to line (
Ctrl+G) — enter a number, jump straight there - Command palette (
Ctrl+P) — fuzzy-find files, switch themes - Image viewer — open images directly in the terminal (requires Kitty, Sixel or iTerm support)
- Config —
~/.kiss_conf.json, open withCtrl+O - Help dialog —
Ctrl+H - Splash screen — ASCII logo on startup
- Update check — notifies when a newer version is available on exit
- Enter handling — auto-indent to match the current line on newline
For keybindings and commands, see USAGE.md.
Release files for kiss-editor 0.3.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| kiss_editor-0.3.7.tar.gz | 10.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| kiss_editor-0.3.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 24.5 kB
Release files / kiss_editor-0.3.7.tar.gz
| Download URL | kiss_editor-0.3.7.tar.gz |
|---|---|
| Size | 10.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
16c35114c50aac796b5f5992271ed0945ee8de5ee3a75840c19e749c57bbaec3
|
|
BLAKE2b-256 checksum How to use checksums |
decc819009e0699d76b9a762cc5424407123df2e3abdd74413fdb0f20d2289be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / kiss_editor-0.3.7-py3-none-any.whl
| Download URL | kiss_editor-0.3.7-py3-none-any.whl |
|---|---|
| Size | 13.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
884588303268dc424fd479e658b586887993ddc22294c440900a895c5cbb909b
|
|
BLAKE2b-256 checksum How to use checksums |
64c9ddb16f026e0034017b7c832a122af5801e86a9ae7bb7899ebcae0308a244
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|