Install GNO

Install

Get GNO on your machine in under a minute.

One command. macOS, Linux, and Windows. MIT-licensed, zero telemetry, runs 100% on your own machine. No account required.

$bun install -g @gmickel/gno
License
MIT
Runtime
Bun
Platforms
macOS · Linux · Windows
Telemetry
None

Don’t have Bun yet? Install it with bun.sh, then come back and run the command above.

Per-platform

Pick your operating system.

The install command is the same everywhere — these are the extras specific to each platform.

macOS

Apple Silicon and Intel. Vector search needs the Homebrew SQLite.

  1. Install GNO
    bun install -g @gmickel/gno
  2. Install SQLite (for vector search)
    brew install sqlite3
  3. Verify
    gno doctor

Linux

x86_64 and arm64. Bun handles the binary.

  1. Install GNO
    bun install -g @gmickel/gno
  2. Verify
    gno doctor

Windows

windows-x64 supported. arm64 not yet.

  1. Install GNO
    bun install -g @gmickel/gno
  2. Verify
    gno doctor

Verify

Confirm GNO is ready to go.

gno doctor runs a full environment check: CLI path, SQLite version, model cache, disk space, and embedding freshness.

gno --version
gno doctor
gno status
  • gno --version — prints the installed release.
  • gno doctor — runs diagnostics and flags missing dependencies, including the embedding-fingerprint check for stale or mixed vectors.
  • gno status — shows the active config and collection summary.

Release proof

The npm tarball is smoke-tested.

Before publish, bun run test:package runs scripts/package-smoke.ts: pack with npm pack, install from the tarball into isolated temp paths, prove required files like src/embed/retry.ts are present, and run packaged gno doctor --json.

Desktop beta

Prefer a packaged app?

The desktop build wraps gno serve in a native window with the workspace UI pre-wired. No terminal needed after the first launch.

Download latest buildFull install reference

Next

After install, point GNO at your notes.

Quickstart

Point GNO at a folder, index it, and wire the skill + MCP into your AI tools.

Open

Connect Claude Code

One-line skill install for Claude Code. Also works with Codex, OpenCode, and OpenClaw.

Open

MCP integration

Install GNO as an MCP server for Claude Desktop, Cursor, Zed, Windsurf, and more.

Open

Configuration

Tune collections, presets, and model choices via index.yml and the CLI.

Open

Source

GNO is MIT-licensed and open.

The whole workspace — CLI, SDK, Web UI, MCP server, agent skills — lives in a single repository. Read the source, file issues, send a PR, or fork it for your own experiments.

View on GitHubRead the docs