claude-relay 2.14.0 → 2.15.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +25 -40
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -4,18 +4,11 @@
4
4
  <img src="media/phone.gif" alt="Clay on phone" width="300">
5
5
  </p>
6
6
 
7
- <h3 align="center">A multi-user web UI for Claude Code, built on the Agent SDK.</h3>
7
+ <h3 align="center">Turn Claude Code into a team workspace. Any device, one command.</h3>
8
8
 
9
9
  [![npm version](https://img.shields.io/npm/v/clay-server)](https://www.npmjs.com/package/clay-server) [![npm downloads](https://img.shields.io/npm/dw/clay-server)](https://www.npmjs.com/package/clay-server) [![GitHub stars](https://img.shields.io/github/stars/chadbyte/clay)](https://github.com/chadbyte/clay) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/chadbyte/clay/blob/main/LICENSE)
10
10
 
11
- Clay extends Claude Code from a single-user CLI into a multi-user, multi-session web platform. It runs locally as a daemon, serves a browser UI over WebSocket, and lets non-technical teammates use Claude Code without touching the terminal.
12
-
13
- No relay server in the cloud. Your machine is the server. Zero install — one command:
14
-
15
- ```bash
16
- npx clay-server
17
- # Scan the QR code to connect from any device
18
- ```
11
+ Clay gives Claude Code a browser UI that runs on any device. Use it from your phone, run it on macOS, Windows, or Linux. Invite teammates, manage multiple projects from one sidebar, and get push notifications when Claude needs you. Built on the official Claude Agent SDK, not a terminal parser. Your machine is the server. No cloud relay in between, no extra network surface.
19
12
 
20
13
  ---
21
14
 
@@ -65,6 +58,18 @@ If someone gets stuck, join their session to unblock them in real time. Permissi
65
58
 
66
59
  ---
67
60
 
61
+ ## Mates
62
+
63
+ Build your team, even if you're solo.
64
+
65
+ Mates are AI teammates you create through conversation. Interview them, give them a name, avatar, and role. A code reviewer, a marketing lead, a writing partner. They remember how you work together and carry context across sessions.
66
+
67
+ They sit in your sidebar next to your human teammates. DM them, bring them into projects, let them work autonomously. In a multi-user workspace, your whole team, human and AI, works in one place.
68
+
69
+ <!-- screenshot: sidebar with Mates visible -->
70
+
71
+ ---
72
+
68
73
  ## Mobile & notifications
69
74
 
70
75
  Phone, tablet, couch. All you need is a browser.
@@ -85,15 +90,13 @@ The scheduler kicks off agents at set times.
85
90
  Have it check open issues and submit PRs every morning at 8 AM.
86
91
  Or compile world news and email you a digest every day.
87
92
 
88
- Take it further with Ralph Loop — autonomous iteration built into Clay. Define a task (`PROMPT.md`) and success criteria (`JUDGE.md`), then start the loop. The agent works, commits, and a judge evaluates the git diff as PASS or FAIL. On FAIL, a fresh session starts over. Each iteration has **no memory of previous conversations** — only the code carries over. Based on [Geoffrey Huntley's Ralph Wiggum technique](https://ghuntley.com/loop/).
93
+ Take it further with Ralph Loop, an autonomous coding loop built into Clay. The agent works, commits, and a judge evaluates. If it fails, a fresh session starts over with no memory of the previous attempt. Only the code carries over. Based on [Geoffrey Huntley's Ralph Wiggum technique](https://ghuntley.com/loop/).
89
94
 
90
95
  ---
91
96
 
92
97
  ## Security & Privacy
93
98
 
94
- Clay turns your machine into the relay server. There is no intermediary server on the internet. No third-party service sits between your browser and your code.
95
-
96
- The best relay server to trust is the one that doesn't exist. Clay has none. Your data flows directly from your machine to the Anthropic API — exactly as it does when you use the CLI. No one intercepts, collects, or reroutes it. Clay adds a browser layer on top, not a middleman.
99
+ Your data flows directly from your machine to the Anthropic API, exactly as it does when you use the CLI. Clay adds a browser layer on top, not a middleman.
97
100
 
98
101
  PIN authentication, per-project/session permissions, and HTTPS are supported by default. For local network use, this is sufficient. For remote access, we recommend a VPN like Tailscale.
99
102
 
@@ -119,11 +122,12 @@ PIN authentication, per-project/session permissions, and HTTPS are supported by
119
122
 
120
123
  ## Key Features
121
124
 
125
+ * **Mates** - AI teammates with persistent identity, context, and memory. Create through an interview, DM them, collaborate across sessions.
122
126
  * **Multi-user** - Accounts, invitations, per-project/session permissions, real-time presence.
123
127
  * **Multi-agent** - Parallel agents per project, sidebar switching.
124
128
  * **Push notifications** - Approval, completion, error. Native-like PWA experience.
125
129
  * **Scheduler** - Cron-based automatic agent execution.
126
- * **Ralph Loop** - Autonomous coding loop with PROMPT.md + JUDGE.md. Iterates until the judge says PASS.
130
+ * **Ralph Loop** - Autonomous coding loop. The agent works, a judge evaluates, and it iterates until it passes.
127
131
  * **File browser** - File exploration, syntax highlighting, live reload.
128
132
  * **Built-in terminal** - Multi-tab terminal, mobile keyboard support.
129
133
  * **Session search** - Full-text search across all conversation history.
@@ -136,47 +140,29 @@ PIN authentication, per-project/session permissions, and HTTPS are supported by
136
140
  **"Is this just a terminal wrapper?"**
137
141
  No. Clay runs on the Claude Agent SDK. It doesn't wrap terminal output. It communicates directly with the agent through the SDK.
138
142
 
139
- **"Is it free? Open source?"**
140
- Free. MIT-licensed open source. All code is public.
141
-
142
- **"Do I need to install anything?"**
143
- No. `npx clay-server` runs it directly. No global install, no build step, no Docker. Node.js and Claude Code are the only prerequisites.
144
-
145
143
  **"Does my code leave my machine?"**
146
144
  The Clay server runs locally. Files stay local. Only Claude API calls go out, which is the same as using the CLI.
147
145
 
148
- **"Is it secure?"**
149
- PIN authentication, per-project/session permissions, and HTTPS are supported by default. See [Security & Privacy](#security--privacy) for details.
150
-
151
- **"What OS does it run on?"**
152
- Windows, Linux, and macOS are all supported.
153
-
154
146
  **"Can I continue a CLI session?"**
155
147
  Yes. Pick up a CLI session in the browser, or continue a browser session in the CLI.
156
148
 
157
149
  **"Does my existing CLAUDE.md work?"**
158
150
  Yes. If your project has a CLAUDE.md, it works in Clay as-is.
159
151
 
160
- **"Can I use it as an app?"**
161
- PWA is supported. On mobile, tap the download icon in the top-left corner to open the PWA install guide. Once installed, it provides a native-like experience.
162
-
163
- **"Can I use the terminal on mobile?"**
164
- Yes. Clay provides a built-in terminal with mobile keyboard support.
165
-
166
152
  **"Does each teammate need their own API key?"**
167
153
  No. Teammates share the Claude Code session logged in on the server. If needed, you can configure per-project environment variables to use different API keys.
168
154
 
169
155
  **"Does it work with MCP servers?"**
170
156
  Yes. MCP configurations from the CLI carry over as-is.
171
157
 
172
- **"How do I update?"**
173
- Auto-update is supported. When a new version is available, apply it with one click.
158
+ **"What are Mates?"**
159
+ AI teammates you create through a conversation. Each Mate has a name, avatar, personality, and persistent memory. They live in your sidebar and you can DM them or bring them into projects.
174
160
 
175
- **"Can I use other AI models besides Claude?"**
176
- Currently Clay is Claude Code only. Other model support is on the roadmap.
161
+ **"How is a Mate different from Claude Projects?"**
162
+ Claude Projects save prompts and files as context. A Mate is a teammate. It has its own identity formed through an interview, remembers how you work together across sessions, and exists alongside your human teammates in the workspace. You're not organizing prompts. You're building a team.
177
163
 
178
- **"Can I run it in Docker?"**
179
- There's no official Docker image yet, but it can run in a container with a Node.js environment.
164
+ **"Can I create multiple Mates?"**
165
+ Yes. Create as many as you need. A code reviewer, a writing partner, a project manager. Each one is independent.
180
166
 
181
167
  ---
182
168
 
@@ -222,8 +208,7 @@ npx clay-server --dev # Dev mode (foreground, auto-restart on lib/ change
222
208
 
223
209
  ## Architecture
224
210
 
225
- Clay is not a wrapper that intercepts stdio.
226
- It's a local relay server that drives Claude Code execution through the [Claude Agent SDK](https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk) and streams it to the browser over WebSocket.
211
+ Clay drives Claude Code execution through the [Claude Agent SDK](https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk) and streams it to the browser over WebSocket.
227
212
 
228
213
  ```mermaid
229
214
  graph LR
package/package.json CHANGED
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "claude-relay",
3
- "version": "2.14.0",
3
+ "version": "2.15.0-beta.1",
4
4
  "description": "Alias for clay-server — Web UI for Claude Code.",
5
5
  "bin": {
6
6
  "claude-relay": "./bin/cli.js"
7
7
  },
8
8
  "dependencies": {
9
- "clay-server": "2.14.0"
9
+ "clay-server": "2.15.0-beta.1"
10
10
  },
11
11
  "keywords": [
12
12
  "claude",