Tiny is an IDE, text editor, personal knowledge management system, and file browser that lives in the terminal. Search, git, a map, a terminal and plugins are built in. Plain files in plain folders; nothing proprietary.
Full installation size:
8.60 MB Linux (x86_64), 7.89 MB Linux (arm64)
7.90 MB macOS (Intel), 7.26 MB macOS (Apple silicon)
8.15 MB Windows (x86_64), 7.50 MB Windows (arm64)
Try it here: https://msaunders.dev/tiny/
Linux, macOS
curl -fsSL https://raw.githubusercontent.com/mattsaund/tiny/main/install.sh | shWindows
irm https://raw.githubusercontent.com/mattsaund/tiny/main/install.ps1 | iexDownloads the newest release for
your machine (or builds it), puts it in your applications menu and among the
programs that open text files, and offers git and ffmpeg if they are missing.
tiny tells you when a new version is out, and y updates it. tiny --update does
the same; tiny --uninstall removes tiny and leaves your files alone.
What changed: CHANGELOG.
Arch Linux, from the AUR:
yay -S tiny-ide-bin # or tiny-ide, built from sourcepacman updates it with everything else.
tiny # this folder
tiny ~/notes # that folder, made if it is missing
tiny ~/code/main.py # that file*cd ~/notes opens another folder without leaving tiny.
Esc steps out of the part you are in, the arrows pick another (white), and
Enter goes in (green). A click goes straight in. Esc never quits; Ctrl+Q
does.
/ searches names and contents as you type. /fn \w+/ is a regex. * starts
a command.
Click anywhere, drag or Shift to select. Ctrl+C Ctrl+X Ctrl+V use your
system's clipboard. Tab finishes words. Alt+N and Alt+Shift+Up/Down add
cursors. Ctrl+R records keys, Ctrl+P plays them.
Ctrl+W next pane. *split, *split down, *close. Drag a border between
any two parts to resize them.
Ctrl+O opens your shell under the panes, and comes back.
Ctrl+G. Enter stages, commit commits, with the git you already have.
The branches are under the changes: Enter switches, n makes one, d
deletes, m merges. The browser shows changed files in yellow, new ones in
green and ignored ones in gray. Beside the line numbers, lines new since the
last commit are marked green, changed ones blue, and red marks where lines were
deleted. No repository yet: initialize, publish or clone from the same window.
Ctrl+L. Wikilinks, markdown links, calls and paths between files, in any
language: green reaches this file, red is what it reaches.
Markdown renders as you read it; Enter edits. Headings at every level,
tables, fenced code with syntax colors, quotes and task lists. Pictures, video,
audio and PDFs open in your own viewer. Click a link to follow it: web
addresses open in your browser, links to files open in tiny.
? shows every key, and so does man tiny.
| key | does |
|---|---|
arrows, i j k l |
move, pick a part |
Enter, Esc |
go in, step out |
Ctrl+S |
save (on a folder, all of it) |
/, Ctrl+F |
search |
* |
a command |
| click, drag | place the cursor, select |
Ctrl and a click |
follow a link |
| click or drag a scrollbar | scroll there |
Shift and a move, Ctrl+A |
select, select all |
Tab |
finish a word, or a command |
Ctrl+C, Ctrl+X, Ctrl+V |
copy, cut, paste |
Alt+N, Alt+Shift+Up/Down |
more cursors |
Ctrl+R, Ctrl+P |
record keys, play them |
Ctrl+G, Ctrl+L |
git, map |
Ctrl+W, Ctrl+O |
next pane, terminal |
Ctrl+T, < > |
hide the browser, its width |
| drag a border | resize |
Ctrl+N |
another tiny window |
Ctrl+Q |
quit |
Say it in words; Tab finishes them. The line under the bar says what Enter
will do.
*goto line 42 *copy temp.txt to notes
*goto function main *move temp.txt to notes
*goto word todo in a.md *rename old.md to new.md
*goto file notes.md *new notes/today.md
*replace hi with hello *delete old.md
*replace hi with hey in a.md *set tab_width to 2
*replace /(\w+)@a/ with $1@b *split down
*play 20 *close
Names are found anywhere in the project. No in means everywhere. go to,
open, cp, rm, *42 and the rest work too.
A plugin is a Lua file in the plugins folder, which Plugins in settings
opens. Drop one in and *reload.
-- words.lua: *words counts them
tiny.command("words", function()
local n = 0
for _ in tiny.text():gmatch("%S+") do n = n + 1 end
tiny.status(n .. " words")
end)tiny.command tiny.on("open"/"save") tiny.status tiny.text
tiny.set_text tiny.insert tiny.cursor tiny.go tiny.path tiny.root
tiny.open tiny.set
*config opens the settings; tiny --config prints where tiny.conf is.
tiny uses your terminal's font and colors, and picks its characters and
colors to suit the terminal it is in. glyphs (unicode, console,
ascii) and colors (truecolor, 256, 16, none) override that.
cursor_shape (block, bar, underline) and cursor_blink set the
cursor. Keys go in [keys]:
glyphs = "ascii"
[keys]
down = "z"
editor.undo = "ctrl+u"AI policy. I am open to AI and agentic coding, but the code written needs to follow specific guidelines:
- MUST be human readable, acceptable variable/function names.
- Easily traceable, following a good program flow.
- Contributors MUST look at and document code and code changes. You need to understand the code that is being written.
Tests. cargo test, cargo clippy and cargo fmt. CI runs all three on
Linux, macOS and Windows, and starts tiny in a terminal there: under eleven
terminal names, at several sizes, and inside tmux and GNU screen. A version
is released by tagging it; see .github/workflows/release.yml.
Created by Matthew Saunders, https://msaunders.dev
MIT. See LICENSE. Everything compiled in (every crate, Lua, the
color themes) is permissive, with its copyright and license in
THIRD-PARTY-NOTICES.txt; tiny --licenses prints
it, with the syntax definitions from bat via
two-face.







