Noa

agent
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 7 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in bench/run_all.sh
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

GPU-accelerated terminal emulator for macOS and Linux, independently implemented in Rust (winit + wgpu): built for output floods, orchestrates coding agents in worker panes, and aims for observable Ghostty compatibility.

README.md

Noa

Noa

Noa is a GPU-accelerated terminal emulator for macOS and Linux, implemented independently
in Rust with winit and wgpu. It is built to be the fastest terminal at
swallowing output floods (cat huge.log, build logs, CI streams), runs
coding agents (Claude Code, Codex, agy) in worker panes it can orchestrate,
and aims for observable compatibility with Ghostty
while keeping the core terminal model reusable and testable.

Website: https://simota.github.io/Noa/

Noa is under active development. It builds from source and installs with
Homebrew on Apple Silicon Macs (see below). The macOS app bundle targets macOS 13 or later. Fixture-based regression tests cover
terminal behavior; automated differential comparison against Ghostty is still
planned.

Quick start

Use Rust 1.92 or newer (Rust 2024 edition); CI builds with Rust 1.92.0.

cargo run -p noa

To build a double-clickable macOS app:

scripts/bundle-macos.sh
open target/release/Noa.app

The bundle script creates a local ad-hoc-signed app. It is not a notarized
distribution workflow.

Install with Homebrew

Noa currently supports Apple Silicon Macs. Install the cask from this source
repository as a custom tap:

brew tap simota/noa https://github.com/simota/Noa.git
brew install --cask simota/noa/noa

Installation requires a GitHub Release for the version declared in
Casks/noa.rb, containing Noa-<version>-macos-arm64.zip. Maintainers create
it by pushing a v<workspace-version> tag; the release workflow verifies that
the Cargo, Cask, tag, and app-bundle versions match before publishing the
archive and its SHA-256 checksum.

The cask uses sha256 :no_check: the checksum published with each release is
not written into Casks/noa.rb. When the signing secrets are configured,
release artifacts are Developer ID signed and notarized, so Gatekeeper accepts
the download without a prompt; without them the workflow falls back to ad-hoc
signing. See
docs/release-signing.md for the required secrets and
local testing steps.

Linux

Noa also builds and runs on Linux (X11 and Wayland); see
docs/LINUX.md for the full guide. Ghostty's
Linux (GTK) keybindings are the defaults: ctrl+shift+c/ctrl+shift+v copy and
paste, ctrl+shift+t opens a tab, ctrl+shift+p opens the command palette.

Build dependencies (Debian/Ubuntu names):

sudo apt install build-essential pkg-config libfontconfig1-dev libfreetype-dev \
  libxkbcommon-dev libwayland-dev

At runtime Noa needs a Vulkan driver (Mesa or a vendor driver) or OpenGL ES as
a fallback, and loads X11/Wayland and libxkbcommon dynamically. Fonts come
from fontconfig: the default is the first installed of JetBrains Mono, DejaVu
Sans Mono, Noto Sans Mono, Ubuntu Mono, and Liberation Mono (then the generic
monospace alias), with fontconfig fallback for CJK, emoji, and symbols.

To build a tarball with the desktop entry, AppStream metadata, and icons, and
install it into ~/.local (or any prefix):

scripts/package-linux.sh
tar -xzf target/release/Noa-*-linux-*.tar.gz -C /tmp
/tmp/Noa-*-linux-*/install.sh                  # or: --prefix /usr/local
/tmp/Noa-*-linux-*/install.sh --uninstall      # remove again

Tagged releases also publish Noa-<version>-linux-x86_64.tar.gz with the same
layout. The window's Wayland app id / X11 WM_CLASS is com.simota.noa.

Desktop integration uses standard tools: clipboard and the PRIMARY selection
(copy-on-select, middle-click paste), xdg-open for links and files,
notify-send for desktop notifications, and canberra-gtk-play (when
installed) for the audible bell. Linux limitations compared to macOS:

  • quick-terminal-hotkey is not registered system-wide (Wayland offers no
    global-shortcut API to applications); a toggle_quick_terminal keybinding works
    while a Noa window is focused. On Wayland the quick terminal appears at its
    edge without sliding (see docs/LINUX.md).
  • macOS-only integrations are absent: the menu bar and Ember, AppleScript,
    Dock badges, background blur, and the native AppKit overlay cards (the
    command palette and dialogs are drawn by the GPU renderer instead).
  • File previews open in your editor instead of a native text panel.
  • Encrypted scrollback persistence needs the macOS Keychain, so restored
    sessions come back without their scrollback.

Releasing

Maintainers can validate and publish the version declared in Cargo.toml and
Casks/noa.rb with the release script:

scripts/release.sh --dry-run
scripts/release.sh

The script requires a clean main branch that exactly matches origin/main,
runs formatting, locked workspace build, and locked workspace tests, then asks
for confirmation before creating and pushing the matching v<version> tag.
Use scripts/release.sh --yes only for trusted non-interactive automation.

If an invalid release must be withdrawn before users depend on it, delete the
GitHub Release first, then its remote and local tags:

gh release delete v0.1.0 --repo simota/Noa --yes
git push origin :refs/tags/v0.1.0
git tag -d v0.1.0

Performance

Render throughput is 220–233 MB/s across plain, ANSI, and CJK workloads. CJK
is the fastest of the three: wide-character handling carries no cost. Command
overhead is 1336 µs (zsh), idle input latency is 1.2–1.3 ms, and settled idle
memory is 52 MB.

Every number is reproducible with the bundled benchmark harness
(bench/run_all.sh), and performance changes are gated on it. See
Positioning for the full claim and
Methodology for how the numbers are measured.

Key features

  • GPU-rendered terminal grid with Kitty graphics support
  • Tabs, splits, floating panes, multiple windows, session restore, and quick and scratch terminals
  • Agent workflows: attention tracking, pane-scoped notifications, and Noa +ctl orchestration of worker panes with a live board
  • DEC/ANSI VT handling, Kitty keyboard protocol, shell integration, and search
  • Font fallback, ligatures, background images, opacity, and blur
  • Ghostty-compatible configuration, live reload, and 575 bundled themes (574 from Ghostty plus Noa)
  • macOS menus, command palette, notifications, Ember menu-bar status, and secure keyboard entry

See Features for the complete feature inventory.

Agent orchestration

An agent or script in one pane can drive worker panes with Noa +ctl: spawn
Claude Code, Codex, agy, or any command, send prompts, wait on each worker's
reported state, read its output, and close it. Every command prints one JSON
object per line. The first spawn opens Noa +ctl board beside the
orchestrator: a queue of workers that need a person above the tree of work in
progress, with a preview of the selected worker's screen. Workers live in
floating panes stowed on the board.

Enable the control server first:

server-enable = true
server-scopes = read,control,input

See Agent workflows for
the commands and a full round.

Configuration

Noa reads its configuration from $XDG_CONFIG_HOME/noa/config, or
~/.config/noa/config when XDG_CONFIG_HOME is unset. CLI flags override file
values.

window-width = 100
window-height = 30
font-size = 15.0
theme = "Catppuccin Mocha"

One-shot queries include +version, +list-themes, +list-keybinds,
+list-fonts, +show-config, +explain-config, +list-actions, and +help.

Importing a Ghostty configuration

From a source checkout, run:

cargo run -p noa -- --import-ghostty-config

For a Homebrew installation in /Applications, run the executable inside the
app bundle:

/Applications/Noa.app/Contents/MacOS/Noa --import-ghostty-config

Noa imports every existing Ghostty configuration candidate in this order:

  1. $XDG_CONFIG_HOME/ghostty/config.ghostty
  2. $XDG_CONFIG_HOME/ghostty/config
  3. ~/Library/Application Support/com.mitchellh.ghostty/config.ghostty
  4. ~/Library/Application Support/com.mitchellh.ghostty/config

When XDG_CONFIG_HOME is unset or empty, the first two paths use ~/.config
instead. The generated Noa configuration is
$XDG_CONFIG_HOME/noa/config, or ~/.config/noa/config when the variable is
unset or empty.

Lines whose keys are supported scalar settings, plus keybind lines, are
copied unchanged. Non-comment lines that cannot be parsed as directives, and
directives whose keys are unsupported, are retained as comments; existing
comments and blank lines are preserved. In particular, config-file directives
are commented out and their referenced files are not followed. When multiple
candidates exist, their contents are appended in the order above, so later
scalar values take precedence and keybind lines retain that order. The import
refuses to overwrite an existing Noa configuration. Back up or rename the
existing file before retrying if replacement is intended.

See the Configuration reference for supported keys and
defaults, and Keybindings for shortcuts and actions.

Compatibility and limitations

Noa is an independent reimplementation and does not include or link Ghostty
source code. Compatibility work focuses on observable terminal behavior rather
than source-level equivalence.

  • The application is macOS-first; Linux is supported with the limitations
    listed under Linux.
  • Current parity protection is fixture-based; the automated Ghostty oracle is
    not implemented yet.
  • Some advanced terminal behavior may still differ from Ghostty.
  • Installation is available from source or through the custom Homebrew tap,
    which installs the archive from the matching GitHub Release.

See the parity harness and
parity roadmap for current coverage
and planned work.

Development

cargo build --workspace
cargo test --workspace
cargo fmt --all

Noa is a Cargo workspace. noa-vt and noa-grid implement the terminal parser
and state model without windowing dependencies. noa-render owns GPU rendering,
while noa-app owns the winit event loop and macOS integration. The binary in
bin/noa is a thin entry point.

Dependency boundaries are intentional: only noa-app and noa-render use
wgpu, and only noa-app uses winit.

License

MIT. See LICENSE.

Reviews (0)

No results found