Druk

A code editor for the terminal. File tree, tabs, search, git marks and syntax highlighting for 30+ languages — keyboard and mouse.

Install

druk is one self-contained executable. Nothing else to install — no Node, no Bun.

curl -fsSL https://druk.sh/install | bash

Or through a package manager:

brew install letstri/tap/druk
npm install -g druk
bun add -g --trust druk

On Debian or Ubuntu take the .deb from the releases page (sudo dpkg -i druk_*.deb); on Fedora or openSUSE the .rpm (sudo rpm -U druk-*.rpm). macOS (arm64, x64), Linux (arm64, x64) and Windows (x64).

druk update upgrades whichever way you installed, printing the command first. druk diffs [path] opens straight on the uncommitted changes, sidebar hidden.

Install options

The script puts the binary in ~/.druk/bin and adds it to your PATH. Pin a version with | bash -s -- --version 1.0.1, or keep your shell config untouched with --no-modify-path. The npm and bun packages are a launcher that downloads that same binary on install — set DRUK_DOWNLOAD_BASE to a mirror if your network cannot reach GitHub.

Open a project

druk                  # the current directory
druk ./my-app         # a directory
druk src/main.ts      # a single file
druk src/main.ts:42:7 # …at line 42, column 7

npx druk and bunx druk work without installing anything.

The basics

A file tree on the left, tabs along the top, the editor, and a status bar with the branch, unsaved state and cursor position.

• Tab moves from the tree to the editor, Esc moves back. In the tree: ↑ ↓ to move, → ← to open and close folders, Enter to open a file.
• Opening a file from the tree previews it: the tab is italic and the next file you open takes its place. Double-click it, or start editing, and it stays.
• F1 opens the command palette — every feature is in there, so no shortcut has to be remembered. Ctrl+K lists every key that works right now.
• The mouse works throughout. Selecting code copies it — including to the clipboard of the machine you are SSH'd from.

Shortcuts

Key	Does
F1 or Ctrl+Opt+P	Command palette
Ctrl+P or Ctrl+O	Open any file in the project (fuzzy)
Ctrl+K	Peek at every key for the pane you are in
Ctrl+T	Switch between open tabs
Ctrl+S	Save
Ctrl+F	Find in this file (Tab adds replace)
Ctrl+Opt+F	Find in the whole project (Ctrl+R too, outside vim mode)
Ctrl+G	Go to line
Ctrl+N	New file
Ctrl+W	Close tab
Ctrl+B	Show / hide the sidebar
Ctrl+Q	Quit
Ctrl+Z / Ctrl+Y	Undo / redo
Ctrl+C / Ctrl+X / Ctrl+V	Copy / cut / paste (system clipboard, OSC52 over SSH)
Ctrl+U	Delete to the start of the line — what macOS terminals send for Cmd+Delete
Ctrl+/ or Ctrl+L	Toggle comment
Opt+↑ / ↓	Move line or selection
Opt+Shift+↑ / ↓	Duplicate line or selection
Ctrl+Opt+T	Reopen closed tab
F8 / Shift+F8	Next / previous problem
Ctrl+Opt+← / →	Previous / next tab
Ctrl+Opt+C	Copy the path of this file
Ctrl+Opt+G	Source control panel
Ctrl+Opt+R	Review panel
Ctrl+Opt+A	Note this line for a review
Ctrl+Opt+M	Markdown: rendered / source
Ctrl+Opt+X	Extensions panel
Ctrl+Opt+W	Switch workspace (worktrees + recent folders)

In the tree: a new file, A new folder, r rename, d delete, x cut, c copy, p paste here, Shift+↑/↓ select several rows, [ / ] resize the sidebar.

Ctrl+C copies when text is selected and quits when nothing is. Most terminals cannot tell Ctrl+Shift from plain Ctrl, so a second modifier is spelled Ctrl+Opt — terminals speaking the kitty keyboard protocol take Ctrl+Shift too. Opt is Option (⌥) on macOS, Alt everywhere else.

Non-English layouts, dead keys and IMEs work: shortcuts follow the physical key, typing follows the text your layout produces. On macOS, configuring Option solely as a Meta key prevents character entry.

Search

Ctrl+F searches the open file, Ctrl+Opt+F the project. Whatever you had selected is already in the box, and the panel reopens with the query and position you left it on. Results are grouped by file with the hit previewed in context; Tab folds a file.

Tab in file search opens the replace field (Find → Replace in project for the project): Enter replaces the selected match, Ctrl+A every match. Ctrl+C, Ctrl+W and Ctrl+R toggle case-sensitive, whole-word and regex matching.

Files

x picks a file or folder up, c copies, p drops it in the folder you are on — paste onto a file and it lands beside it. Nothing is overwritten: a taken name gets a copy suffix. Open tabs, unsaved edits and expanded folders follow whatever you move or rename, and bulk operations run in the background.

Git

Changed lines are marked in the gutter and beside the scrollbar; files in the tree carry M A U D marks, and the status bar shows the branch and its distance from upstream (⎇ main ↑2 ↓1 ~3). Work done in another terminal shows up without a restart.

Ctrl+Opt+G swaps the sidebar for a source-control panel: ↑↓ walks the changes and opens the diff beside it, a stacks every file in one scrollable page, c commits, d discards, p pushes, b switches branch, s syncs, g opens the commit graph. Pull, fetch, stash, undo-commit, branch comparison, worktrees and conflict resolution are in the palette.

P opens the branch's GitHub pull request on the same diff page, with GitHub's own viewed checkboxes: Space on a file marks it viewed on github.com and folds it, as the web does, and o opens the pull request in the browser. It goes through the GitHub CLI — gh auth login once and there is nothing to configure.

Review

Ctrl+Opt+A notes the line or selection under the cursor as an issue, suggestion, question or note, shown as ◆ in the gutter and after the line. Ctrl+Opt+R opens the panel: ↑↓ pages the file beside the list and opens the remark as a card under its line, r answers one (making a thread), Backspace drops one.

Notes live in review.json beside the config, keyed by project — an agent can read and answer them while druk is open, and the panel updates as it writes. Nothing goes over a network: there is no forge to configure and no token to set.

Settings

F1 → Settings: one row per option, ←→ steps the value, Enter opens a filterable list. Changes apply immediately and persist. Or edit ~/.config/druk/config.json, which a project can override in <project>/.druk/settings.json.

Setting	Default
theme	"dark"	dark and light ship with druk; ayu, catppuccin, dracula, everforest, gruvbox, kanagawa, nord, one-dark, rosé pine, solarized, tokyo night and more are one install away in the market
transparent	false	leave the editor, tab strip and sidebar unpainted, for a translucent terminal
iconTheme	"none"	file icons: unicode, or a set from the market — nerd-icons needs a patched font
tabSize	2	1–16
cursorStyle	"block"	block, line or underline (vim mode overrides it)
wrap	true	false keeps each line on one row
scrollPastEnd	true	scroll on past the last line
vim	false	normal / insert / visual modes, hjkl w b 0 $ gg G, f t F T, counts, i a o, x dd dw cw, v + d y c, yy p P, u / Ctrl+R
sidebarWidth	"auto"	a quarter of the window, or pin 15–80 columns
sidebarPosition	"left"	which side the sidebar sits on
trimOnSave	false	strip trailing spaces, end the file with one newline
autoSaveOnBlur	true	save unsaved tabs on tab switch or window blur
showDotfiles	true	false hides dotfiles in the tree
respectGitignore	false	true hides git-ignored files in the tree
diffView	"inline"	inline or split
reviewInline	true	false keeps review notes out of the text
extensionUpdates	true	check the market at startup; false never contacts it
checkUpdates	true	check npm for a newer druk at startup; false never contacts the registry, and druk update still works
extensionRegistry	druk's own	point it at a fork if you keep your own market

druk remembers each project's open tabs, active file and expanded folders. Ctrl+Opt+W switches to another folder — every worktree of the open repositories, then every folder druk has been opened on.

Extensions

Almost everything druk does with a language or a colour is an extension, and the market is a folder in this repository that druk reads directly — so a new theme or language reaches you when its pull request merges, not when druk next releases.

Out of the box: TypeScript, JavaScript and their React dialects, JSON, Markdown, HTML, CSS, YAML and TOML. Go, Rust, Python, C, C++, Java, Ruby, Elixir, PHP, Swift, Lua, Bash and about fifteen more are one install away, each bringing its language server. A language may have several servers and druk runs all of them — so ESLint reports beside whichever language server already serves the file.

Ctrl+Opt+X opens the extensions panel: / searches what you have and what the market offers alike, Enter installs (or toggles an installed one) after naming what it adds and any command druk would run, Backspace uninstalls, u updates everything. druk also offers on its own — open a Go file with no Go extension and it says so.

An extension is a JSON manifest — installing one runs nothing. Write your own into ~/.config/druk/extensions/<name>.json, or a project's <project>/.druk/extensions/, and press r in the panel:

{
  "id": "nim",
  "name": "Nim",
  "version": "1.0.0",
  "languages": [
    {
      "id": "nim",
      "lineComment": "#",
      "extensions": [".nim"],
      "grammar": { "wasm": "grammar.wasm", "query": "highlights.scm" }
    }
  ],
  "languageServers": [
    {
      "id": "nim",
      "command": ["nimlangserver"],
      "filetypes": ["nim"],
      "install": { "kind": "manual", "command": "nimble install nimlangserver" }
    }
  ]
}

An extension is one kind or the other: a language (as above) or an appearance (themes and icons). grammar can also be {"vendored": "go"} for a grammar already inside druk, or a patterns list of regexes where no grammar exists. An id matching one already registered replaces it — that is how to repaint dark.

extensions/README.md has the full shape, and contributing one is a JSON file and a pull request.