Mayoi is a free, open source frameworks & platforms project written in Go and released under MIT. It has 520 GitHub stars, 76 forks and 27 open issues, and was last pushed 9 hours ago. On this registry it ranks #141 of 145 tracked projects in Frameworks & Platforms, with 5 head-to-head comparisons available.

What is Mayoi?

Mayoi is a small, fast, MIT-licensed code editor written in Go that draws a native GPU-rendered UI with MyGo — no webview and no Electron — and it is aimed at developers who want a lightweight native editing environment rather than a browser-engine-based one.

What it is

Mayoi is a desktop code editor implemented in Go, released under the MIT licence and distributed as a packaged app of roughly 18 MB. Its interface is drawn natively on the GPU with MyGo, so the application ships without a webview or an Electron runtime, and it carries the code-editor, go, golang, gpu, macos, native-app and text-editor topics in this registry. The repository has 520 stars, 76 forks and 27 open issues, and its most recent push was in November 2026.

The problem it addresses is the weight of the modern editor stack: instead of embedding a browser engine to render text and panels, Mayoi draws its own UI on the GPU and keeps the packaged application small. It lives in the Go and macOS native-application ecosystem, and it replaces the Electron- and webview-based editors that otherwise fill the role of a general-purpose desktop code editor, folding source control, a terminal, previews and remote folders into the same window.

Key capabilities

  • Modal editing through a Vim mode with normal, insert and visual modes, motions, operators, text objects, counts, ., registers, macros, marks, search, and : commands such as :s, :g and :normal.
  • Source control in a Git view that stages, commits, amends, undoes, pulls and pushes, with every change in one diff, a commit graph of branches and tags, gutter marks that revert or stage a change, and blame.
  • A GitHub sidebar listing open issues and pull requests, with issues read and commented on in tabs, a pull request's conversation, changes, commits and checks in one tab, and Work on Issue, which hands an issue to an agent in a worktree of its own.
  • Remote SSH that opens a folder on another machine with the system's ssh and nothing installed there, running the Explorer, search, Git and terminals on the host and forwarding its ports to the local machine.
  • A terminal built on Ghostty's emulator (libghostty-vt), placed in the bottom panel, at a side of the window or in a tab.
  • Plugins in JavaScript or TypeScript with no build step, run in Mayoi's own engine and covering commands, views, previews, formatters, diagnostics, themes, snippets and language servers, on SSH folders too.

Who uses it and how

  • Developers on macOS who want a native editor with a small footprint: the packaged application is about 18 MB and the UI is drawn on the GPU rather than in a webview.
  • Vim users who want modal editing inside a graphical editor, with registers, macros, marks and : commands available alongside tabs, split columns and a live file tree.
  • Developers whose code lives on another machine, who open a remote folder over the system's ssh with nothing installed on the host and work with the Explorer, search, Git and terminals there while its ports forward back.
  • Teams that review on GitHub, who read and comment on issues in tabs, review a pull request's conversation, changes, commits and checks before merging from the same tab, and hand an issue to an agent with Work on Issue.

Getting started

Mayoi is distributed from its homepage at usemayoi.com, where the packaged app of about 18 MB is available, while building, testing and releasing from source are documented in CONTRIBUTING.md. Once installed, a mayoi shell command opens files at a given line, compares them, waits for them to close and runs any command.

How it compares

Among the tools named in its documentation, Mayoi sits beside VS Code, whose keyboard shortcut format it adopts for its own settings and shortcut editor, and it relies on Ghostty's emulator (libghostty-vt) for its terminal instead of writing one. Unlike editors built on a webview or on Electron, it draws its interface itself on the GPU with MyGo, which is what keeps the packaged app at about 18 MB.

When to use it — and when not to

Choose Mayoi when a native, GPU-drawn editor with Vim mode, Git and GitHub views, an integrated Ghostty terminal and remote SSH folders matches the way you work. Do not choose it if the cloud features need to work without an account: AI commit messages and settings sync both require signing in, with GitHub or Google. It is also a small project — 520 stars, 76 forks and 27 open issues — and its topics and documented shortcuts point to macOS rather than to a broad cross-platform release.

project readme (upstream, from github) — read inline

Mayoi

迷い — a small, fast code editor written in Go. It draws a native UI on the GPU with MyGo, with no webview and no Electron, and the packaged app is about 18 MB.

usemayoi.com

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
  • GitHub: a sidebar view of the issues and pull requests open, issues read and commented on in tabs, a pull request's conversation, changes, commits and checks in one tab, reviewed and merged from there, Work on Issue that hands an issue to an agent in a worktree of its own, and review threads sent to an agent as notes
  • 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, GTA VI with wanted stars, 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
  • Plugins: JavaScript or TypeScript with no build step, run in Mayoi's own engine: commands, views, previews, formatters, diagnostics, themes, snippets and language servers, on SSH folders too (see docs/PLUGINS.md)

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

Columns: split the editor and drag tabs between columns
Vim mode: motions, operators, text objects and visual mode
Peek a change: click a gutter mark to see the lines at HEAD, then revert or stage them
Side-by-side diff: every change in one tab, with changed words tinted
Commit graph: branches, tags and merges, and each commit's changes in a tab
Markdown preview: live beside the source
Terminal: Ghostty's emulator in the panel or, here, in a tab
Command palette: every command by name, with its shortcut
Search in files: as you type, with each match in context
Project tabs: every folder in one window, on a rail
Remote SSH: the Explorer, Git, search and terminals on the host, and its ports here
The Matrix: one of the themes, with the whole window in the code's font

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 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

Privacy

Mayoi sends an anonymous count once a day and on each update, with only its version and system. Set usageStats to false to turn it off. Crash reports are sent only when you say so. See docs/PRIVACY.md.

License

MIT

Frequently asked questions

Is Mayoi free to use?

Mayoi is open source under the MIT licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does Mayoi do?

A small, fast code editor written in Go, with a native GPU-drawn UI (no webview, no Electron)

What is Mayoi written in?

Mayoi is primarily written in Go. Its source is publicly available at https://github.com/sorrycc/Mayoi, and it has 520 GitHub stars.