Skip to main content

TurboVI

A vi clone for the terminal: modes, counts, operators, registers, marks, macros, split windows, :s, find-in-project with a quickfix list, and Markdown shown rendered. About 6,200 lines of Python, 3,800 of them code.

uv sync
uv run turbovi somefile.py
uv run turbovi one.py two.py   # two buffers, :bn between them
uv run turbovi somefile.py +42 # on line 42
uv run turbovi                 # a scratch buffer

:q to leave, :help for what is here.

What a vim user gets

The grammar, ["x] [count] operator [count] motion, over hjkl w b e ge W B E 0 ^ $ gg G { } f F t T ; , % H M L. Operators d c y > < gu gU g~ gc ! with doubling (dd, yy, gcc), text objects (iw aw i( a" i{ i< ip it), and x X D C s S r R ~ J gJ Y p P o O, <C-a> and <C-x>. In insert mode, <C-w>, <C-u> and <C-r>x.

Modes: normal, insert, visual, visual-line, visual-block and command.

Paging with <C-f> <C-b> <C-d> <C-u>, by the window rather than by a fixed number, <C-e> / <C-y> to move the view without moving the cursor, and zt zz zb to put the cursor's line at the top, middle or bottom.

Search with / ? n N * # and match highlighting, :set ignorecase and smartcase, and \c and \C in a pattern. Undo and redo with u and <C-r>. . repeats the last change, recorded as keystrokes the way vi does it, so a change that ends in insert mode replays whole.

:s with ranges (%, ., $, 1,5, .+1), the g, i and n flags, any non-alphanumeric delimiter, and & in the replacement. One u undoes the whole substitution.

Commenting with gc: gcc for a line, gcip for a paragraph, gc on a selection. The block toggles as one, as in Neovim, with the marker the file's syntax uses and :set commentstring for the rest.

Shell commands as vi has them: :%!sort and !ip run lines through a command and put back what it prints, :!make runs one, and :w !wc -w hands it the buffer. A command that fails leaves the text alone.

Marks: ma puts one down, `a comes back to the character and 'a to the first non-blank of that line. Every jump leaves a mark, so `` returns from a G or a search. `:marks` lists them. They are not shifted when the text moves, which is the one place this is smaller than vi.

Macros: qa records into register a, q stops, @a plays, 3@a plays three times, @@ repeats the last. They share storage with the yank registers the way vi's do, so "ap pastes a macro as text and @a runs a yanked line. A macro that calls itself stops with a message rather than a stack that runs out.

Several files at once with :e :ls :bn :bp :b, split windows with :sp and :vsp, and <C-w> then w s v c o or h j k l to move between them. <C-p> and :find are a fuzzy picker over the project: type a few letters of the path and it opens in the current window.

Find in project on <C-g> or :grep: a box that searches on every keystroke, grouped by file, with the match underlined where it actually is. ^A case, ^W whole word and ^R regex are shown rather than hidden — a search box whose rules you cannot see is one you stop trusting the first time it misses something you know is there.

Enter fills the quickfix list and jumps, as vim's :grep does. :copen shows the list with a line of context either side, :cn and :cp walk it, Enter in the pane goes to the entry under the cursor, and :cdo s/from/to/g rewrites every line in it and writes the files. The pane is an ordinary buffer whose text is built from the list, which is what saves the editor from growing a second kind of window.

The system clipboard on "+y and "+p. A copy goes out over OSC 52 and a local helper, so it crosses an ssh session; a put needs the helper, because reading back means waiting for the terminal to answer and a terminal that ignores the request never does.

Your terminal's own mouse still works. TurboVI does not turn mouse reporting on, so double-click, triple-click, drag, Cmd+C and Cmd+V all do what they do everywhere else. Mouse reporting is a mode of the terminal: switching it on would hand this editor click coordinates and take selecting and copying away from the terminal, and no program can have both. A paste arrives as text rather than as commands, however big it is and whatever mode you are in.

Markdown, rendered. gR shows a Markdown file laid out and coloured, read-only but with every motion, search and yank working on it, and gR again goes back to the source on the same word. i, a or o go back to the source as well and start typing there, so you can fix a typo the moment you read it. Lines are 80 columns at most, :set readerwidth to change it. Enter follows a link and <C-o> comes back. :render html lynx -dump -stdin -width={width} renders any other format through a command.

Syntax colouring from the file's name. :set syntax=rust colours a file with no suffix, :set nosyntax stops. A search hit and a selection paint over the colouring, because finding something inside a comment has to be visible.

.editorconfig, honoured. Read from the buffer's own directory upwards, stopping at the first root = true, with the nearest section winning: indent_style, indent_size, tab_width, end_of_line, insert_final_newline and trim_trailing_whitespace. Hand-rolled rather than taking a second dependency. charset is deliberately ignored — the encoding is detected from the bytes, and a config file overriding that would silently re-encode every file it was wrong about.

A file opens and saves as itself. The encoding, the line endings and whether the last line had a newline are read once and written back unchanged. A latin-1 file stays latin-1, a CRLF file stays CRLF, and a file with no trailing newline does not gain one.

Settings and recovery

Settings live in $XDG_CONFIG_HOME/turbovi/config, a file of ex commands the way a vimrc is:

set nu
set rnu
sp

A modified buffer is copied to $XDG_DATA_HOME/turbovi/recover/ every few seconds, keyed by a hash of its absolute path, and :recover puts it back after a crash without writing anything to disk. The recovery copy is dropped when the buffer is saved.

What it is not

Not a vim: no plugins, no scripting language, no :g, no folds, no tabs, no persistent undo across sessions yet. Searches are Python re rather than vim's own dialect. Differences from vim lists every place it behaves differently, on purpose or not yet.

Built on turbodesk

turbodesk is the immediate-mode terminal UI library underneath. This editor is the application on it that draws its own buffer: views, events and hooks, with no editor() widget under the text. That is what proved the core carries a real application on its own. Two dialogs are the library's, the <C-p> file picker and the frame around the find box. It lived in that repository as examples/vi/ until 2026-08-26; a smaller showcase version stays there.

Metadata

Release files for turbovi 0.6.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 turbovi 0.6.0
File Size Uploaded Provenance Actions
turbovi-0.6.0.tar.gz 89.4 kB Without provenance Details for turbovi-0.6.0.tar.gz

Built distribution (wheel)

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

Total release size: 186.0 kB

Release files / turbovi-0.6.0.tar.gz

Download URL turbovi-0.6.0.tar.gz
Size 89.4 kB
Tags Source
SHA-256 checksum
How to use checksums
b07c53e5a23967b3c271c87665dea2e2bf9f4d3d0d2414bdb5510ca08e260f1b
BLAKE2b-256 checksum
How to use checksums
448b899d3d14d20a5117081b20c8683a54e3a72f09e3d9b911472f2d030f90b6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / turbovi-0.6.0-py3-none-any.whl

Download URL turbovi-0.6.0-py3-none-any.whl
Size 96.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
37a636de50b02c2cebdacd156b9dae824cfc10fd3ad4ed97bb426ca73785c6d6
BLAKE2b-256 checksum
How to use checksums
8cc31efae8e3485d792a6fe0c62bb94da720476666c559a193ba07e46161ff87
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for turbovi 0.6.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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