Docs

Getting started

NOBLE is a single native binary that turns your terminal into a workspace: real shells in tabs and splits, your git projects, live system sensors and your AI quota. This page gets you from zero to your first session.

Install

Windows (x86_64)

In PowerShell, no admin rights needed. It installs into your user folder and adds it to your PATH:

PowerShell

$dir = "$env:LOCALAPPDATA\Programs\noble"
Invoke-WebRequest https://github.com/MertSoylu/noble/releases/latest/download/noble-windows-x86_64.zip -OutFile "$env:TEMP\noble.zip"
Expand-Archive "$env:TEMP\noble.zip" $dir -Force
$path = [Environment]::GetEnvironmentVariable("Path", "User")
if ($path -notlike "*$dir*") { [Environment]::SetEnvironmentVariable("Path", "$path;$dir", "User") }

Or download the .zip and put noble.exe anywhere on your PATH.

Linux (x86_64 and ARM64)

The Linux binaries are static, so they run on any distribution:

x86_64

curl -fsSL https://github.com/MertSoylu/noble/releases/latest/download/noble-linux-x86_64.tar.gz | tar -xz noble
install -Dm755 noble ~/.local/bin/noble

ARM64

curl -fsSL https://github.com/MertSoylu/noble/releases/latest/download/noble-linux-aarch64.tar.gz | tar -xz noble
install -Dm755 noble ~/.local/bin/noble

With Cargo (Rust 1.88+)

shell

$ cargo install noble

From source

shell

$ git clone https://github.com/MertSoylu/noble && cd noble
$ cargo install --path .

Note: Windows and Linux are both fully supported: CI runs the whole test suite, real terminals and end-to-end tests included, on both. macOS should build but is not tested yet. Reports and fixes are welcome.

First launch

Run noble. A short boot sequence shows what NOBLE found (skip it with any key, or turn it off with boot_animation = false). On the very first launch a welcome card lists the projects it found, the four keys worth knowing and a choice of prefix key, so it doesn’t clash with your shell:

⏎ opens a terminal in the selected project
c x start Claude Code or Codex right there
alt+p opens the command palette: every action, project, tab and theme is in there
? shows every shortcut; ctrl+click opens links

Everything else is on screen and clickable. See Keys and mouse for the full reference.

Terminal requirements

Any truecolor terminal with a regular monospace font works; no Nerd Font needed. Windows Terminal, WezTerm, Kitty, Alacritty, GNOME Terminal, Konsole and iTerm2 are all fine. Cascadia Code and Cascadia Mono render every glyph NOBLE uses (box drawing, block elements, braille).

Copy and paste use the system clipboard (Windows, X11 and Wayland). Without one, for example over SSH, copied text is sent to your terminal with OSC 52, links are copied instead of opened, and files and the config open in a terminal editor ($EDITOR, else nano or vim).

A Windows Terminal profile

To open NOBLE in its own tab from the Windows Terminal dropdown, add this profile:

settings.json

{ "name": "NOBLE", "commandline": "noble.exe", "icon": "⌂", "font": { "face": "Cascadia Mono" } }

Command line

usage

noble [--config <path>] [--no-boot]
      --paths      print config and data locations
      --version    print version
noble update       download and install the latest release
noble update --check   only report whether there is one

Updating

NOBLE checks GitHub for a new release once a day and shows it at the bottom right. Click update there, or run noble update. It downloads the prebuilt binary for your platform and replaces the installed one; restart NOBLE afterwards. Turn the check off with check_updates = false or in Settings. All archives are also on the releases page.