Noa
Health Uyari
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 7 GitHub stars
Code Basarisiz
- rm -rf — Recursive force deletion command in bench/run_all.sh
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
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.

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 inCasks/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 genericmonospace 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-hotkeyis not registered system-wide (Wayland offers no
global-shortcut API to applications); atoggle_quick_terminalkeybinding works
while a Noa window is focused. On Wayland the quick terminal appears at its
edge without sliding (seedocs/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 andCasks/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 +ctlorchestration 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:
$XDG_CONFIG_HOME/ghostty/config.ghostty$XDG_CONFIG_HOME/ghostty/config~/Library/Application Support/com.mitchellh.ghostty/config.ghostty~/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 inbin/noa is a thin entry point.
Dependency boundaries are intentional: only noa-app and noa-render usewgpu, and only noa-app uses winit.
License
MIT. See LICENSE.
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi