Install GNO

Getting Started

Installation

Install GNO via Bun, verify with gno doctor, and configure vector search on macOS.

GNO ships as a Bun-compiled CLI that also exposes a web server, a TypeScript SDK, and an MCP server. One install gives you all of them.

macOS and Linux

bun install -g @gmickel/gno

On macOS, vector search requires the Homebrew build of SQLite so GNO can load the SQLite extension for vector similarity:

brew install sqlite3

After install, verify with gno doctor. It checks for the CLI, SQLite, models, and disk space.

gno doctor

Windows

Current support target is windows-x64. The CLI path works via Bun/global install, and the desktop beta ships as a packaged Windows zip on GitHub Releases. Windows arm64 is not supported yet.

bun install -g @gmickel/gno

Desktop beta

The packaged desktop shell wraps gno serve in a native window with the workspace UI pre-wired. Grab a build from GitHub Releases and run it like any other desktop app.

Verify your install

gno --version
gno doctor
gno status

gno doctor surfaces path resolution, SQLite version, model cache location, disk space, and embedding freshness. gno status stays lightweight: it shows the currently active config file and collection summary without probing native model runtimes.

Release package proof

GNO releases run bun run test:package before publish. That script packs the npm tarball with npm pack, installs from that tarball into isolated temporary paths, verifies required packed files including src/embed/retry.ts, then runs the packaged gno --version, gno --help, and gno doctor --json.

The packaged doctor proof is specific: JSON must include the embedding-fingerprint check and its embeddingFingerprint payload with currentFingerprint, pendingChunks, legacyChunks, mixedGroups, and groups.

Connect your AI tools

The CLI is only one way to use GNO. Most users plug it into their AI tools so search, retrieval, and citations happen automatically. One command per client:

# Coding agents (zero-overhead skill install)
gno skill install --target claude --scope user # Claude Code
gno skill install --target codex --scope user
gno skill install --target openclaw --scope user
gno skill install --target all --scope user # all agents

# AI assistants and editors (MCP)
gno mcp install --target claude-desktop
gno mcp install --target cursor
gno mcp install --target zed
gno mcp install --target windsurf
gno mcp install --target claude-code
gno mcp status

Full client list + write-access options: MCP reference. Per-client setup guides: Claude Code, Claude Desktop, Cursor.

Next steps