selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
clay logo

Self-host clay

v5.4.0

Collaborative workspace for humans and AI coding agents

BetaOpen SourceAGPL-3.0
Updated9 hours ago
LanguageJavaScript
Setup difficultyModerate
MobilePWA
ThemeDark mode
Stars
406
Port
2633 (HTTP/WebSocket server)
Requires
Node.js
Install with NPM
clay screenshot 1clay screenshot 2clay screenshot 3

What is clay?

Clay Studio is a self-hosted workspace that lets developers and AI coding agents work together in shared projects and live sessions. It runs as a local Node.js daemon on your machine, serving a browser-based workspace accessible from any device. The software integrates with ten different coding agents — detecting locally installed runtimes automatically. Core capabilities include shared projects with live collaboration (presence, cursors, mentions, handoffs), persistent AI collaborators called Mates with their own identity and memory, cross-provider continuity via the YOKE interface, parallel background work using git worktrees and Ralph Loops, a PWA for mobile with push notifications, and built-in tools for file browsing, terminals, MCP servers, and skill management. All data stays on your infrastructure in portable JSONL and Markdown files. Multi-user mode supports role-based access with admin controls. The project is licensed under AGPL-3.0-only and distributed via npm as clay-server.

Should you self-host clay?

clay scores 49/100 on selfhost.directory (how scoring works) and ranks #47 of 120 in AI Assistant. It has 406 GitHub stars.

It shipped 9 stable releases in the past year. The latest, v5.4.0, came out on 22 October 2026. New versions land roughly every 6 days.

Setup is moderate: expect some configuration beyond a single command. It is AGPL-3.0-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is hermes-agent (89/100, 257 926 stars). It scores higher overall, so compare the two before you pick. See clay vs hermes-agent side by side.

Features

  • Built-in development tools
  • Cross-provider continuity (YOKE)
  • Git worktree support
  • Local-first data storage
  • MCP server connections
  • Multi-user mode with role-based access
  • Parallel and background work
  • Persistent AI collaborators (Mates)
  • Ralph Loop autonomous cycles
  • Reverse proxy and tunnel support
  • Shared projects and live sessions
  • Skill management

clay README

How to install clay

Install clay with NPM

Environment variables
CLAY_HOME (optional, for daemon config location)

npx clay-server

Open the URL or scan the QR code from another device

Requires Node.js 20+ and at least one supported coding-agent CLI installed and authenticated.

clay releases & version history

More in Collaboration

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…