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 buildThe 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
npxone-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.