Skip to content

install.md

Latest commit

 

History

History
108 lines (77 loc) · 3.09 KB

install.md

File metadata and controls

108 lines (77 loc) · 3.09 KB
Raw

Docs › Getting started › Install

Install

Get the continuity program onto your machine and confirm it runs.

Audience: operator · Read time: ~2 min

Continuity is a single program. Nothing else needs to be installed for it to run — no Docker, no Node.js, no Python.

Pick one

# macOS / Linux — install script
curl -fsSL https://raw.githubusercontent.com/lazypower/continuity/main/install.sh | sh

# Homebrew
brew install lazypower/tap/continuity

# Homebrew — development channel, rebuilt from the main branch, expect rough edges
brew install lazypower/tap/continuity-dev

# Arch Linux (AUR) — community maintained by @klrmngr
yay -S continuity-bin

# From source — needs Go 1.24+
git clone https://github.com/lazypower/continuity.git
cd continuity && make build

The install script downloads and immediately runs code from GitHub. If you would rather read it first:

curl -fsSL https://raw.githubusercontent.com/lazypower/continuity/main/install.sh -o install.sh
less install.sh
sh install.sh

Check it worked

continuity version
continuity v0.11.0 (commit: 4afa791, built: 2026-08-01)

Your version and commit will differ — any output here means the install worked. If you get command not found, the binary is not on your PATH. Homebrew puts it in /opt/homebrew/bin (Apple Silicon), /usr/local/bin (Intel macOS and Linux); the install script uses /usr/local/bin. Add that directory to PATH in your shell profile.

Start the server

continuity serve
continuity serving on 127.0.0.1:37777
  db: ~/.continuity/continuity.db
  llm: claude-cli (haiku)
  embedder: model2vec:potion-retrieval-32M:512

That last line may pause for a moment on a brand new install — the built-in search method downloads a ~33 MB model file once, into ~/.continuity/models/. If you are offline, Continuity falls back to simple keyword matching for now and tells you so.

Leave that running and open a second terminal.

Or run it as a managed service instead — recommended, and what most people want. Only one server can hold the port, so stop the foreground one first (Ctrl-C in that terminal):

continuity install-service

This shows you exactly what it will install and asks before doing anything. It starts Continuity on login and restarts it if it crashes — a LaunchAgent on macOS, a systemd user unit on Linux. Remove it with continuity uninstall-service.

The server keeps running after you close your terminal. To stop it, see Stopping it.

What gets created

Path What it is
~/.continuity/continuity.db Everything Continuity stores
~/.continuity/serve.log Server log
~/.continuity/models/ Downloaded search model, if used
~/.continuity/config.toml Settings — only if you create it

Full list in Files and paths.

Next: Connect it to Claude Code See also: Configuration · Troubleshooting