Fast, cross-platform terminal emulator with native UI and GPU acceleration.
Thirty-nine lines: build commands, three directories and two absolute rules.
File measured on main at commit 9897d6c. Analysis written 2026-09-14. Star count is a snapshot from September 2026.
The shortest file in the directory. It covers how to build, how to run a subset of tests, where the three main source trees are, and what the agent may not open on GitHub.
Quoted lines are verbatim from the file. Open one to see it where it sits.
Contribution etiquette
Never create an issue, never create a PR. The rule then specifies what to do if the user asks anyway: write a line into the diff. The effect is that the instruction shows up in the change rather than in a GitHub action.
Verification by change type
Targeted tests are preferred because the full suite is slow, and the filter flag is given twice, once for the main suite and once for the vt library.
On macOS, a flag skips the app bundle when it is not needed, which speeds up compilation.
Every C enum in the public header directory takes a max-value sentinel to force integer sizing, with pre-C23 portability given as the reason.
Ghostty's file tells an agent how the codebase works. It cannot tell it which bug three customers hit this week. Modem keeps that context current and attaches it to the work.