Mayoi

https://github.com/user-attachments/assets/673e7907-2b2c-4ed6-9093-1ba9633cd61c

Features

• Editor: tabs, Chroma syntax highlighting, indent guides, sticky scroll, breadcrumbs and word wrap
• Smart editing: auto-indent, auto-closing brackets and quotes, line commands, and per-tab undo
• Vim mode: normal, insert and visual modes, with motions, operators, text objects, counts and ., registers, macros, marks, search, and : commands as :s, :g and :normal
• Columns: split the editor side by side and drag tabs between columns
• Explorer: a live file tree that follows the disk and dims Git-ignored files
• Quick open: fuzzy file search, go to line (:42), go to symbol (@) and a command palette (>, ⇧⌘P)
• Find and replace: case, whole-word and regex matching, searched in the background in large files
• Search: find and replace across the folder's files (⇧⌘F, ⇧⌘H), with files to include and exclude, and a preview of each replacement
• Git: a source control view to stage, commit, amend, undo, pull and push, every change in one diff, folded around the changes, inline or side by side, a graph of the commits with their branches and tags, each with its own diff, gutter marks that revert or stage a change, branches and blame
• Terminal: Ghostty's emulator (libghostty-vt), in the bottom panel, at a side of the window, or in a tab
• Remote SSH: open a folder on another machine with the system's ssh, nothing installed there: the Explorer, search, Git and terminals run on the host, and its ports forward to this machine
• Image viewer: PNG, JPEG, GIF, WebP and BMP
• Previews: a live preview of Markdown, SVG and Mermaid beside the source (⇧⌘V), with the Markdown's Mermaid blocks drawn as diagrams and its LaTeX math as formulas
• Windows: a window per folder or every folder in one window as project tabs, a welcome page with the recent folders and hosts, Open Recent (⌃R), and a mayoi shell command that opens files at a line, compares them, waits for them to close and runs any command
• Themes: light and dark, The Matrix with digital rain and the White Rabbit, Purple Gold, the Halloween themes Jack-o'-Lantern, Witch's Brew and Blood Moon, and Claude, Qoder, Grok Bot and Cursor, each in light and dark
• Auto save, and every window reopened as you left it, with its columns, tabs and carets
• Settings: a settings window with search and a keyboard shortcuts editor, over JSON files applied as you save them, with the code's and the terminal's fonts, weight, ligatures and line height, keyboard shortcuts in VS Code's format, and a folder's own settings in .mayoi/settings.json (see docs/SETTINGS.md)
• AI commit messages: signed in, write the commit message from the changes with Mon's AI gateway
• Settings sync: sign in with GitHub or Google, and your settings and keyboard shortcuts follow you between machines

See docs/FEATURES.md for the details, docs/ARCHITECTURE.md for a tour of the source and how fast it runs, and CONTRIBUTING.md to build, test and release Mayoi.

Tour

Installation

macOS

Requires macOS 13 or later. Install with Homebrew on Apple Silicon or Intel:

brew tap --custom-remote sorrycc/mayoi https://github.com/sorrycc/Mayoi.git
brew trust sorrycc/mayoi
brew install --cask mayoi

Recent Homebrew refuses to load casks from a tap you haven't trusted, which brew trust allows once. On an older Homebrew without that command, skip that line.

Or download the DMG for your Mac from Releases and drag Mayoi to Applications. Both methods install the signed, notarized app.

Open Mayoi from Applications, or run mayoi . or mayoi <file> in a shell. Homebrew installs and removes the shell command with the app. For a DMG installation, choose File → Install 'mayoi' Command in the app instead.

If you already installed the command through Mayoi, choose File → Uninstall 'mayoi' Command before installing with Homebrew, so only one mayoi command is on your PATH.

Mayoi checks for updates automatically. To upgrade with Homebrew, run brew update && brew upgrade --cask mayoi; if it refuses to load the cask from an untrusted tap, run brew trust sorrycc/mayoi first.

Linux

Requires GTK 3, such as on Ubuntu 22.04 or later:

curl -fsSL https://github.com/sorrycc/Mayoi/releases/latest/download/install.sh | sh

The installer adds Mayoi to ~/.local, with the mayoi command and an entry in the applications menu.

Windows

Download the installer for your architecture from Releases.

Build from source

Requires Go 1.27 or later; Linux also needs GTK 3. From the repository:

go run ./cmd/mayoi ~/some/project    # open a folder or a file
go tool mygo build                   # build build/darwin-arm64/Mayoi.app and a .dmg

See CONTRIBUTING.md for development and testing.

Keyboard shortcuts

Shortcut	Action
⌘P / ⇧⌘O / ⌃G	Quick open / go to symbol / go to line
⌘F / ⌥⌘F / ⌘G	Find / replace / next match
⇧⌘F / ⇧⌘H	Find in files / replace in files
⌘S / ⇧⌘S / ⌥⌘S	Save / save as / save all
⌘O / ⌥⌘O / ⌃R	Open folder / open folder in a new window / open recent
⌘N / ⌘W / ⌘1…9 / ⌃Tab	New file / close tab / go to tab / next tab
⇧⌘] / ⇧⌘[ / ⌃⌘1…9	Next / previous / go to project, with project tabs
⌘\ / ⌥⌘→ / ⌥⌘←	Split right / next column / previous column
⌘B / ⌃` / ⌃⇧`	Toggle sidebar / toggle terminal panel / new terminal
⌘Z / ⇧⌘Z	Undo / redo
Tab / ⇧Tab, ⌘] / ⌘[	Indent / outdent
⌘/	Toggle line comment
⌥↑ / ⌥↓, ⇧⌥↑ / ⇧⌥↓	Move line / copy line
⇧⌘K / ⌘↵ / ⇧⌘↵	Delete line / insert line below / insert line above
⌘L / ⇧⌘\	Select line / go to bracket
⌘= / ⌘- / ⌘0	Zoom the whole window in / out / reset
⇧⌘V	Toggle SVG preview
⌥Z	Toggle word wrap for the current tab

License

MIT