Skip to content

Repository files navigation

TuiCode

A minimalist terminal code editor inspired by VS Code.

Installing

macOS / Linux via Homebrew:

brew install mentaldesk/tap/tuicode

Windows via Scoop:

scoop bucket add mentaldesk https://github.com/mentaldesk/scoop-bucket
scoop install tuicode

Other channels (winget, Linux packagers) are tracked in #43 and #44. In the meantime, pre-built single-file binaries for every supported RID are attached to each GitHub Release.

Running

tuicode                  # the folder you're in
tuicode src/App.cs       # that file, with the folder you're in in the explorer
tuicode ~/projects/api   # that folder
tuicode src/App.cs:42    # that file, cursor on line 42 (`:42:9` for a column too)
tuicode src/*.cs         # every match as a tab, the first one active
tuicode --help           # every flag the CLI takes

A path that isn't there is offered for creation first, so a typo doesn't leave an empty file behind.

Needs a real terminal — the app won't render through a non-TTY pipe. On macOS, prefer iTerm2, Ghostty, WezTerm, or Alacritty over Terminal.app, which strips most three-modifier key combos and breaks some chord shortcuts. On Linux, kitty / foot / GNOME Terminal with modifyOtherKeys all work.

Getting help

Contributing

See CONTRIBUTING.md for branch/PR/release workflow and AGENTS.md for code-level conventions (key handling, theming, AOT, the test framework). Written for AI coding agents but just as useful for humans.

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages