Nautili
Documentation

Install Nautili

The nt terminal client with one command, or the desktop app for macOS, Windows and Linux.

Install Nautili

Nautili runs on your machine and talks to api.nautili.ai. Nothing else needs to run locally.

Terminal client

curl -fsSL https://nautili.ai/install.sh | bash

This puts nt in ~/.nautili/bin and adds it to your PATH. Then:

nt login
cd <project>
nt

Alpine and other musl-based Linux: install libstdc++ first (apk add libstdc++); the nt binary needs it at runtime.

Options: --version 0.1.0 pins a version, --no-modify-path leaves your shell config alone. The script verifies every download against the release's SHA256SUMS.

On Windows, in PowerShell:

irm https://releases.nautili.ai/install.ps1 | iex

This puts nt.exe in ~\.nautili\bin and adds it to your PATH.

With Homebrew

brew install devzero-inc/nautili/nautili

macOS and Linux. brew upgrade keeps it current, and nt upgrade runs it for you.

With npm

npm install -g @nautili/tui

Works on macOS, Linux and Windows; pnpm, yarn and bun global installs work too. npm installs the prebuilt nt binary for your platform alongside a small Node launcher.

With Nix

The nautili-harness-flake packages the terminal client and the desktop app for Linux (x64) and macOS (Apple Silicon). To run nt without installing it:

nix run github:devzero-inc/nautili-harness-flake

To add it to your own flake, NixOS or home-manager configuration, see the examples in the repository's README.

Desktop app

Download from nautili.ai/download: macOS (Apple Silicon and Intel), Windows (x64), and Linux (AppImage, .deb, .rpm on x64).

  • macOS: open the .dmg and drag Nautili to Applications. The app is signed and notarized by Apple, so it opens like any other downloaded app.
  • Windows: run the .exe.
  • Linux: chmod +x the .AppImage and run it, or install the .deb / .rpm.

On macOS you can also install it with Homebrew:

brew install --cask devzero-inc/nautili/nautili-desktop

The app updates itself after that.

The Windows app is not yet signed: on the SmartScreen prompt choose More info → Run anyway.

With Nix (Linux x64 and Apple Silicon macOS), run it from the flake:

nix run github:devzero-inc/nautili-harness-flake#nautili-desktop

Preprod

Testing against api.nautili.dev? The preprod build installs as nt-preprod, next to any nt you already have. Get it from the preprod download page, or run:

curl -fsSL https://releases.nautili.ai/preprod/install | bash

On Windows, use irm https://releases.nautili.ai/preprod/install.ps1 | iex. Then run nt-preprod login. npm and Homebrew carry stable only.

Updating

nt upgrade installs the current version of the terminal client, through npm if that is how you installed it. The desktop app updates itself. Versions 0.0.4 and earlier can't: download the current version from the same page once and replace the installed one.

The Nix packages turn off self-updating; update the flake input instead (nix flake update).

Checksums

Every release publishes SHA256SUMS next to its files; the links are on the download page.

On this page