Zephr Docs

Self-hosting

Zephr is not yet published to npm and there is no managed cloud today. Self-hosting from source is the working path.

Requirements

  • Node.js 24.x
  • pnpm 11.x
  • Linux x64

Build

The source repository is private during beta. Request access before running:

git clone https://github.com/DigitalSoftDistribution/zephr.git
cd zephr
pnpm install --frozen-lockfile
pnpm --filter @zephr-ai/protocol build && pnpm --filter @zephr-ai/core build
pnpm --filter @zephr-ai/mcp-server build && pnpm --filter @zephr-ai/mcp build

The build produces apps/mcp/dist/main.cjs, the entry point your MCP client launches.

Run

Point your client at apps/mcp/dist/main.cjs over stdio, with an absolute ZEPHR_DB_PATH, and admit a connection to a worktree with the trusted launcher. See Connect your client.

What is not self-hosted today

  • npm distribution — not shipped; no npx one-liner or global install.
  • Managed cloud — hosted sync across machines is planned, not shipped.
  • Windows / macOS — not claimed supported yet.

See Releases for distribution status.