@clagentic/console 1.0.0-beta.4 → 1.0.1-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.
- package/CREDITS.md +1 -0
- package/LICENSE +1 -0
- package/README.md +64 -174
- package/bin/cli.js +10 -15
- package/lib/agents-favorites.js +1 -0
- package/lib/ask-user-mcp-server.js +1 -0
- package/lib/config.js +1 -0
- package/lib/crisis-safety.js +1 -0
- package/lib/daemon.js +38 -2
- package/lib/dm.js +1 -0
- package/lib/mcp-local.js +1 -0
- package/lib/os-users.js +1 -0
- package/lib/pages.js +8 -71
- package/lib/project-connection.js +3 -28
- package/lib/project-external-trigger.js +1 -0
- package/lib/project-http.js +1 -0
- package/lib/project-knowledge.js +3 -2
- package/lib/project-loop.js +1 -1
- package/lib/project-mcp.js +1 -0
- package/lib/project-memory.js +1 -0
- package/lib/project-sessions.js +2 -1
- package/lib/project-user-message.js +2 -1
- package/lib/project.js +1 -0
- package/lib/public/app.js +2 -1
- package/lib/public/css/admin.css +23 -0
- package/lib/public/css/base.css +52 -0
- package/lib/public/css/channel-layout.css +1 -0
- package/lib/public/css/debate.css +1 -0
- package/lib/public/css/filebrowser.css +14 -0
- package/lib/public/css/home-hub.css +1 -0
- package/lib/public/css/icon-strip.css +2 -15
- package/lib/public/css/loop.css +1 -0
- package/lib/public/css/mention.css +2 -1
- package/lib/public/css/server-settings.css +206 -41
- package/lib/public/css/session-search.css +1 -0
- package/lib/public/css/stt.css +1 -0
- package/lib/public/index.html +45 -48
- package/lib/public/modules/admin.js +55 -2
- package/lib/public/modules/app-connection.js +1 -1
- package/lib/public/modules/app-dm.js +1 -1
- package/lib/public/modules/app-favicon.js +1 -0
- package/lib/public/modules/app-home-hub.js +1 -0
- package/lib/public/modules/app-loop-ui.js +1 -1
- package/lib/public/modules/app-loop-wizard.js +1 -1
- package/lib/public/modules/app-messages.js +16 -4
- package/lib/public/modules/app-misc.js +2 -9
- package/lib/public/modules/app-notifications.js +2 -2
- package/lib/public/modules/app-panels.js +13 -7
- package/lib/public/modules/app-projects.js +1 -0
- package/lib/public/modules/app-rate-limit.js +1 -1
- package/lib/public/modules/app-rendering.js +9 -4
- package/lib/public/modules/app-skills-install.js +1 -1
- package/lib/public/modules/command-palette.js +1 -1
- package/lib/public/modules/mention.js +3 -2
- package/lib/public/modules/notifications.js +34 -0
- package/lib/public/modules/playbook.js +1 -0
- package/lib/public/modules/profile.js +1 -1
- package/lib/public/modules/project-settings.js +179 -12
- package/lib/public/modules/project-switcher.js +29 -91
- package/lib/public/modules/server-settings.js +234 -11
- package/lib/public/modules/session-search.js +1 -0
- package/lib/public/modules/sidebar-mobile.js +0 -1
- package/lib/public/modules/sidebar-projects.js +19 -0
- package/lib/public/modules/sidebar-sessions.js +1 -0
- package/lib/public/modules/sidebar-users.js +3 -3
- package/lib/public/modules/store.js +26 -4
- package/lib/public/modules/theme.js +9 -9
- package/lib/public/modules/tools.js +2 -1
- package/lib/public/modules/user-settings.js +1 -1
- package/lib/public/style.css +1 -0
- package/lib/public/sw.js +10 -2
- package/lib/push.js +2 -1
- package/lib/sdk-bridge.js +1 -0
- package/lib/sdk-message-processor.js +11 -0
- package/lib/sdk-worker.js +1 -0
- package/lib/server-auth.js +2 -2
- package/lib/server-dm.js +1 -0
- package/lib/server-palette.js +1 -0
- package/lib/server-settings.js +26 -25
- package/lib/server-skills.js +1 -1
- package/lib/server.js +28 -4
- package/lib/session-search.js +1 -0
- package/lib/sessions.js +4 -1
- package/lib/smtp.js +7 -7
- package/lib/users-auth.js +30 -5
- package/lib/users-preferences.js +1 -0
- package/lib/users.js +2 -0
- package/lib/ws-schema.js +1 -0
- package/lib/yoke/adapters/claude-worker.js +1 -0
- package/lib/yoke/adapters/claude.js +1 -0
- package/lib/yoke/adapters/codex.js +1 -1
- package/lib/yoke/mcp-bridge-server.js +1 -0
- package/package.json +3 -3
package/CREDITS.md
CHANGED
package/LICENSE
CHANGED
package/README.md
CHANGED
|
@@ -1,205 +1,82 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="media/logo/
|
|
2
|
+
<img src="media/logo/console-lockup-256.png" alt="Clagentic:Console" width="260" />
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
|
-
<
|
|
6
|
-
<h4 align="center">
|
|
7
|
-
Drop into a teammate's session live.<br>
|
|
8
|
-
Or pair with AI mates that remember and push back.<br>
|
|
9
|
-
Self-hosted, one toggle between vendors.
|
|
10
|
-
</h4>
|
|
5
|
+
<h4 align="center">AI tooling. Built for builders.</h4>
|
|
11
6
|
|
|
12
7
|
<p align="center">
|
|
13
|
-
<a href="https://www.npmjs.com/package/
|
|
14
|
-
<a href="https://www.npmjs.com/package/
|
|
15
|
-
<a href="https://github.com/
|
|
16
|
-
<a href="https://
|
|
8
|
+
<a href="https://www.npmjs.com/package/@clagentic/console"><img src="https://img.shields.io/npm/v/@clagentic/console" alt="npm version" /></a>
|
|
9
|
+
<a href="https://www.npmjs.com/package/@clagentic/console"><img src="https://img.shields.io/npm/dw/@clagentic/console" alt="npm downloads" /></a>
|
|
10
|
+
<a href="https://github.com/clagentic/clagentic-console/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" /></a>
|
|
11
|
+
<a href="https://ko-fi.com/clagentic"><img src="https://img.shields.io/badge/Support-Ko--fi-FF5E5B?logo=ko-fi&logoColor=white" alt="Support on Ko-fi" /></a>
|
|
17
12
|
</p>
|
|
18
13
|
|
|
19
|
-
|
|
14
|
+
A self-hosted browser console for Claude Code and Claude agents. Everything you get from the CLI — sessions, approvals, agents, tools — in a browser tab, on any device, with push notifications when you need them.
|
|
20
15
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
*A team-shared, self-hosted GUI for Claude Code and Codex CLIs.*
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
npx clay-server
|
|
27
|
-
# Scan the QR code to connect from any device
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
## What's Clay?
|
|
31
|
-
|
|
32
|
-
- **A browser-based workspace for Claude Code and Codex.** Open it on any device, alone or with your whole team.
|
|
33
|
-
- **A place where your team collaborates across projects.** Engineers, PMs, designers, and domain experts share one workspace, hop between projects, drop into each other's sessions.
|
|
34
|
-
- **Your virtual team.** Mates with names, memory, and roles — architect, reviewer, designer, whoever you need. They learn your codebase, push back on bad ideas, and don't reset between sessions.
|
|
35
|
-
- **A multi-project dashboard.** Every repo on your machine in one sidebar. Run agents across several in parallel; permission requests and completions surface as notifications.
|
|
36
|
-
- **A self-hosted dev server.** Runs on your machine in plain JSONL and Markdown. No proprietary database, no cloud relay, no lock-in. Walk away whenever — your data walks with you.
|
|
37
|
-
- **A work-automation system.** Ralph Loop iterates a feature overnight; cron schedules agents while you're away. Wake up to results, or a clean failure trace.
|
|
16
|
+
No extras bolted on. No opinionated workflows. The floor is solid; you build what you need on top.
|
|
38
17
|
|
|
39
18
|
## What it does
|
|
40
19
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
### Every project on one dashboard
|
|
50
|
-
|
|
51
|
-
All your projects live in the sidebar. Jump between them in one click, see live status across each, run agents in several at once. No more `cd ~/work/foo && tmux attach && ...`. One Clay daemon hosts every repo on your machine and gives you a single pane of glass over all of them.
|
|
52
|
-
|
|
53
|
-
### Mates: AI teammates with persistent memory
|
|
54
|
-
|
|
55
|
-
Mates are AI personas with their own CLAUDE.md, knowledge files, and memory that compounds across sessions. They learn your stack, your conventions, your decision history. @mention them mid-session, DM them directly, or drop them into a debate. **They don't flatter you. They push back.**
|
|
56
|
-
|
|
57
|
-
<p align="center">
|
|
58
|
-
<img src="media/mates.gif" alt="An AI teammate (Mate) pushing back on a bad design pitch in Clay" width="640">
|
|
59
|
-
</p>
|
|
60
|
-
|
|
61
|
-
### Debate: structured multi-Mate decisions
|
|
62
|
-
|
|
63
|
-
Stuck on REST vs GraphQL? Monorepo or split? Surface the question to a debate. Pick panelists, set the format, let your Mates argue both sides with moderated turns. You walk away with a recorded decision, not a vibe check.
|
|
64
|
-
|
|
65
|
-
### Parallel worktrees
|
|
66
|
-
|
|
67
|
-
Detect existing git worktrees, spin up new ones from the sidebar, and run agents in each one independently. No more "wait, I have uncommitted changes." Each worktree is an isolated session with its own history.
|
|
68
|
-
|
|
69
|
-
### Ralph Loop: autonomous coding while you sleep
|
|
70
|
-
|
|
71
|
-
Write a `PROMPT.md`, optionally a `JUDGE.md`, hit go. Clay iterates: code, evaluate, retry, until the judge approves or you cap the loop. Run it once, or schedule it on standard Unix cron. Wake up to a finished feature or a clean failure trace.
|
|
72
|
-
|
|
73
|
-
### Web UI, mobile, push notifications
|
|
74
|
-
|
|
75
|
-
Installable PWA on iOS and Android. Push notifications for approvals, errors, and completed tasks. Service worker keeps the app responsive offline. When Claude needs approval, your phone buzzes, you tap approve, the agent keeps going.
|
|
76
|
-
|
|
77
|
-
## Who is Clay for
|
|
78
|
-
|
|
79
|
-
### Small teams (3–10)
|
|
80
|
-
|
|
81
|
-
Engineers, PMs, designers, and domain experts in one workspace. Non-devs read the codebase and ask questions without ever opening an editor. Engineers @mention each other or drop into a teammate's session to help in real time. Share one org-wide API key or let each member bring their own, with costs routing to whoever ran the model.
|
|
82
|
-
|
|
83
|
-
### Larger teams (10+)
|
|
84
|
-
|
|
85
|
-
Per-user, per-project, per-session permissions. On Linux, opt in to OS-level isolation: each Clay user maps to a real Linux account, file ACLs enforced via `setfacl`, processes spawn under the right UID/GID. Per-project API keys for billing separation. Plain JSONL sessions give you an audit trail you can grep.
|
|
86
|
-
|
|
87
|
-
### Solopreneurs and indie developers
|
|
88
|
-
|
|
89
|
-
You don't have a team yet, so Mates are your team. A persistent architect, a reviewer, a designer — each with their own memory, ready to push back on bad ideas. Run Ralph Loop overnight to ship while you sleep. Toggle Claude and Codex per session to balance cost and capability.
|
|
90
|
-
|
|
91
|
-
### Self-hosting developers
|
|
92
|
-
|
|
93
|
-
Your code stays on your machine. Sessions are JSONL, knowledge is Markdown, settings are JSON. No proprietary database, no cloud relay, no middleman. CLAUDE.md, AGENTS.md, `.cursorrules` are all loaded automatically across vendors. Walk away whenever, your data walks with you.
|
|
20
|
+
- **Full CLI parity in the browser.** Every capability you have in Claude Code CLI is available here — tool approvals, model selection, context management, session history.
|
|
21
|
+
- **Named agent sessions.** Talk directly to any agent defined in your Claude Code config. Agents get their own sessions, context, and history. First-class, not bolted on.
|
|
22
|
+
- **Multi-project dashboard.** Every repo on your machine in one sidebar. Jump between projects, run sessions in parallel, see live status at a glance.
|
|
23
|
+
- **Mobile PWA + push notifications.** Installable on iOS and Android. Your phone buzzes when Claude needs approval or finishes a long task — tap to respond from anywhere.
|
|
24
|
+
- **Loop automation.** Write a `PROMPT.md`, hit go. Clagentic:Console iterates: run, evaluate, retry until done or capped. Schedule with standard cron.
|
|
25
|
+
- **Vendor flexibility.** Supports Claude Agent SDK and Codex app-server protocol. Switch per session.
|
|
26
|
+
- **Your data, your machine.** Sessions are JSONL, settings are JSON, knowledge is Markdown. No cloud relay, no proprietary database.
|
|
94
27
|
|
|
95
28
|
## Getting Started
|
|
96
29
|
|
|
97
30
|
**Requirements:** Node.js 20+. Authenticated Claude Code CLI, Codex CLI, or both.
|
|
98
31
|
|
|
99
32
|
```bash
|
|
100
|
-
npx
|
|
33
|
+
npx @clagentic/console
|
|
101
34
|
```
|
|
102
35
|
|
|
103
|
-
On first run
|
|
36
|
+
On first run you'll be asked for a port and whether you're running solo or multi-user. Open the URL from any device on your network.
|
|
104
37
|
|
|
105
|
-
For remote access, use a
|
|
106
|
-
|
|
107
|
-
<p align="center">
|
|
108
|
-
<img src="media/start.gif" alt="Starting Clay daemon from the CLI with npx clay-server" width="600">
|
|
109
|
-
</p>
|
|
38
|
+
For remote access, use a tunnel — Tailscale, Cloudflare Tunnel, or your existing VPN.
|
|
110
39
|
|
|
111
40
|
## CLI Options
|
|
112
41
|
|
|
113
42
|
```bash
|
|
114
|
-
npx
|
|
115
|
-
npx
|
|
116
|
-
npx
|
|
117
|
-
npx
|
|
118
|
-
|
|
119
|
-
npx
|
|
120
|
-
npx
|
|
121
|
-
npx
|
|
122
|
-
npx
|
|
123
|
-
npx clay-server --dangerously-skip-permissions
|
|
124
|
-
# Bypass all permission prompts (requires PIN at setup)
|
|
43
|
+
npx @clagentic/console # Default (port 2633)
|
|
44
|
+
npx @clagentic/console -p 8080 # Specify port
|
|
45
|
+
npx @clagentic/console --yes # Skip prompts, use defaults
|
|
46
|
+
npx @clagentic/console -y --pin 123456
|
|
47
|
+
npx @clagentic/console --add . # Add current directory to running daemon
|
|
48
|
+
npx @clagentic/console --remove . # Remove project
|
|
49
|
+
npx @clagentic/console --list # List registered projects
|
|
50
|
+
npx @clagentic/console --shutdown # Stop daemon
|
|
51
|
+
npx @clagentic/console --dangerously-skip-permissions
|
|
125
52
|
```
|
|
126
53
|
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
## FAQ
|
|
130
|
-
|
|
131
|
-
**"Is this a Claude Code wrapper?"**
|
|
132
|
-
No. Clay drives Claude Code through the [Claude Agent SDK](https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk) and Codex through the Codex app-server protocol. Both are first-class. Clay adds multi-session orchestration, persistent Mates, structured debates, scheduled agents, multi-user collaboration, built-in MCP servers, and a full browser UI on top.
|
|
133
|
-
|
|
134
|
-
**"Can I run Claude Code and Codex in the same workspace?"**
|
|
135
|
-
Yes. Pick a vendor when you open a session. Switch per session. Same projects, same Mates, same memory.
|
|
136
|
-
|
|
137
|
-
**"How are Mates different from Claude Code's sub-agents?"**
|
|
138
|
-
Sub-agents are ephemeral specialists spawned inside a single Claude Code session — a role and a system prompt for one task, then forgotten when the task ends. Mates are persistent teammates with their own knowledge files and memory that survive every session. A sub-agent forgets you the moment it returns; a Mate remembers your codebase, your decisions, and your conventions across months of work. @mention a Mate mid-session, DM it between sessions, or drop several into a debate.
|
|
139
|
-
|
|
140
|
-
**"Does my code leave my machine?"**
|
|
141
|
-
Only as model API calls (the same as using the CLI directly). Sessions, Mates, knowledge, and settings all stay on disk.
|
|
142
|
-
|
|
143
|
-
**"Does my existing CLAUDE.md / AGENTS.md / .cursorrules work?"**
|
|
144
|
-
Yes. Clay loads native instruction files for each vendor and merges the rest into the system prompt automatically.
|
|
145
|
-
|
|
146
|
-
**"Can I continue a CLI session in the browser?"**
|
|
147
|
-
Yes. CLI sessions show up in the sidebar. Browser sessions can be picked up in the CLI.
|
|
148
|
-
|
|
149
|
-
**"Does each teammate need their own API key?"**
|
|
150
|
-
No. Share one org-wide key, or let each user bring their own. On Linux with OS-level isolation, each member can also use their own Claude Code or Codex login.
|
|
151
|
-
|
|
152
|
-
**"What does OS-level isolation actually do?"**
|
|
153
|
-
On Linux, opt in and Clay provisions each user as a real Linux account. File ACLs are enforced via `setfacl`, agent processes spawn under the user's UID/GID, and the kernel handles the rest. One teammate can't read another's project files, even by accident. The guarantee comes from the OS, not from a promise in our code.
|
|
154
|
-
|
|
155
|
-
**"Does it work with MCP servers?"**
|
|
156
|
-
Yes. User-configured MCPs from `~/.clay/mcp.json` plus built-in browser, email, ask-user, and debate servers. All work in both Claude and Codex sessions.
|
|
157
|
-
|
|
158
|
-
**"Can I use it on my phone?"**
|
|
159
|
-
Yes. Install as a PWA on iOS or Android. Push notifications for approvals, errors, and task completion.
|
|
160
|
-
|
|
161
|
-
**"What is d.clay.studio in my browser URL?"**
|
|
162
|
-
A DNS-only service that resolves to your local IP for HTTPS certificate validation. No data passes through it. All traffic stays between your browser and your machine. See [clay-dns](clay-dns/) for details.
|
|
163
|
-
|
|
164
|
-
## Our Philosophy
|
|
165
|
-
|
|
166
|
-
One idea: **user experience sovereignty**.
|
|
167
|
-
|
|
168
|
-
Not a grand statement. A simple wish: not to have your thinking, your work, and your data locked in the moment a vendor changes a price or rewrites a ToS.
|
|
169
|
-
|
|
170
|
-
That shows up in the technical choices we made:
|
|
171
|
-
|
|
172
|
-
- **Your machine is the server.** Browser → your daemon → model API. That's the full chain. No vendor cloud, no relay server, no middle tier syncing your sessions through someone else's infrastructure.
|
|
173
|
-
- **One toggle between vendors.** The adapter layer (YOKE) speaks the Claude Agent SDK and the Codex app-server protocol natively. Switching is a setting, not a migration.
|
|
174
|
-
- **Plain text on disk.** Sessions, Mates, knowledge, and settings live as JSONL and Markdown. No proprietary database. You can `cat`, `grep`, version, and back up everything yourself.
|
|
175
|
-
- **Standard formats only.** CLAUDE.md, AGENTS.md, `.cursorrules`, MCP, Unix cron. If you walk away from Clay, your data walks with you in formats every other tool already understands.
|
|
176
|
-
|
|
177
|
-
That's the principle. The rest of the README is what it makes possible.
|
|
54
|
+
Also available as `clagentic` or `clagentic-console` if installed globally.
|
|
178
55
|
|
|
179
56
|
## Architecture
|
|
180
57
|
|
|
181
|
-
|
|
58
|
+
Clagentic:Console is a self-hosted daemon. It drives Claude Code via the Claude Agent SDK and Codex via the `codex app-server` JSON-RPC protocol through a vendor-agnostic adapter layer (YOKE), and serves a multi-user web workspace over HTTP/WS. Sessions and settings live as plain JSONL/JSON/Markdown on disk.
|
|
182
59
|
|
|
183
60
|
```mermaid
|
|
184
61
|
graph LR
|
|
185
62
|
subgraph Clients
|
|
186
|
-
B1["Browser
|
|
187
|
-
B2["Browser
|
|
188
|
-
Phone["Phone PWA
|
|
63
|
+
B1["Browser"]
|
|
64
|
+
B2["Browser (multi-user)"]
|
|
65
|
+
Phone["Phone PWA + Push"]
|
|
189
66
|
end
|
|
190
67
|
|
|
191
|
-
subgraph Daemon["
|
|
68
|
+
subgraph Daemon["Clagentic:Console Daemon (your machine)"]
|
|
192
69
|
Auth["Auth + RBAC"]
|
|
193
70
|
Server["HTTP / WS Server"]
|
|
194
71
|
Project["Project Context"]
|
|
195
72
|
YOKE["YOKE Adapter Layer"]
|
|
196
|
-
MCP["Built-in MCP servers
|
|
73
|
+
MCP["Built-in MCP servers\nask-user / browser"]
|
|
197
74
|
Push["Push (VAPID)"]
|
|
198
75
|
end
|
|
199
76
|
|
|
200
77
|
subgraph Vendors["Agent runtimes"]
|
|
201
78
|
Claude["Claude Agent SDK"]
|
|
202
|
-
Codex["codex app-server
|
|
79
|
+
Codex["codex app-server\n(JSON-RPC stdio)"]
|
|
203
80
|
end
|
|
204
81
|
|
|
205
82
|
B1 <-->|WS| Server
|
|
@@ -215,31 +92,44 @@ graph LR
|
|
|
215
92
|
Push -.-> Phone
|
|
216
93
|
```
|
|
217
94
|
|
|
218
|
-
For
|
|
95
|
+
For architecture details, sequence diagrams, and key design decisions, see [docs/guides/architecture.md](docs/guides/architecture.md).
|
|
219
96
|
|
|
220
|
-
##
|
|
97
|
+
## FAQ
|
|
221
98
|
|
|
222
|
-
|
|
99
|
+
**"Is this a Claude Code wrapper?"**
|
|
100
|
+
No. Clagentic:Console drives Claude Code through the Claude Agent SDK and Codex through the Codex app-server protocol. It adds multi-session orchestration, named agent sessions, scheduled agents, multi-user support, built-in MCP servers, and a full browser UI on top.
|
|
223
101
|
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
102
|
+
**"What are named agents?"**
|
|
103
|
+
Agents defined in your Claude Code config (`.claude/agents/`) become first-class sessions. You talk to them directly — their own conversation history, context window, and session state. No workarounds.
|
|
104
|
+
|
|
105
|
+
**"Can I run Claude Code and Codex in the same workspace?"**
|
|
106
|
+
Yes. Pick a vendor when you open a session. Switch per session.
|
|
227
107
|
|
|
228
|
-
|
|
108
|
+
**"Does my code leave my machine?"**
|
|
109
|
+
Only as model API calls — the same as using the CLI directly. Sessions, settings, and knowledge all stay on disk.
|
|
110
|
+
|
|
111
|
+
**"Does my existing CLAUDE.md / AGENTS.md work?"**
|
|
112
|
+
Yes. Native instruction files are loaded per vendor and merged automatically.
|
|
113
|
+
|
|
114
|
+
**"Can I continue a CLI session in the browser?"**
|
|
115
|
+
Yes. CLI sessions appear in the sidebar and can be picked up in the CLI.
|
|
116
|
+
|
|
117
|
+
**"Can I use it on my phone?"**
|
|
118
|
+
Yes. Install as a PWA on iOS or Android. Push notifications for approvals, errors, and task completion.
|
|
119
|
+
|
|
120
|
+
**"Does it work with MCP servers?"**
|
|
121
|
+
Yes. User-configured MCPs from `~/.clagentic/mcp.json` plus built-in ask-user and browser servers work in both Claude and Codex sessions.
|
|
229
122
|
|
|
230
|
-
|
|
123
|
+
**"Multi-user support?"**
|
|
124
|
+
Yes. On Linux, opt in to OS-level isolation: each user maps to a real Linux account, file ACLs via `setfacl`, processes spawn under the correct UID/GID.
|
|
231
125
|
|
|
232
|
-
|
|
233
|
-
<img src="https://contrib.rocks/image?repo=chadbyte/clay" />
|
|
234
|
-
</a>
|
|
126
|
+
## Support
|
|
235
127
|
|
|
236
|
-
|
|
128
|
+
If Clagentic:Console is useful to you: [ko-fi.com/clagentic](https://ko-fi.com/clagentic)
|
|
237
129
|
|
|
238
|
-
|
|
239
|
-
[https://github.com/chadbyte/clay/issues](https://github.com/chadbyte/clay/issues)
|
|
130
|
+
## Credits
|
|
240
131
|
|
|
241
|
-
|
|
242
|
-
[https://github.com/chadbyte/clay/discussions](https://github.com/chadbyte/clay/discussions)
|
|
132
|
+
Forked from [Clay](https://github.com/chadbyte/clay) by Chad, used under the MIT License.
|
|
243
133
|
|
|
244
134
|
## Disclaimer
|
|
245
135
|
|
package/bin/cli.js
CHANGED
|
@@ -1236,7 +1236,7 @@ function hasMkcert() {
|
|
|
1236
1236
|
}
|
|
1237
1237
|
|
|
1238
1238
|
// ==============================
|
|
1239
|
-
// Restore projects from ~/.
|
|
1239
|
+
// Restore projects from ~/.clagentic-rc
|
|
1240
1240
|
// ==============================
|
|
1241
1241
|
function promptRestoreProjects(projects, callback) {
|
|
1242
1242
|
log(sym.bar);
|
|
@@ -1254,7 +1254,7 @@ function promptRestoreProjects(projects, callback) {
|
|
|
1254
1254
|
});
|
|
1255
1255
|
|
|
1256
1256
|
promptMultiSelect("Restore projects", items, function (selected) {
|
|
1257
|
-
// Remove unselected projects from ~/.
|
|
1257
|
+
// Remove unselected projects from ~/.clagentic-rc
|
|
1258
1258
|
if (selected.length < projects.length) {
|
|
1259
1259
|
var selectedPaths = {};
|
|
1260
1260
|
for (var si = 0; si < selected.length; si++) {
|
|
@@ -1483,7 +1483,7 @@ async function forkDaemon(mode, keepAwake, extraProjects, addCwd, wantOsUsers) {
|
|
|
1483
1483
|
if (addCwd) {
|
|
1484
1484
|
var slug = generateSlug(cwd, []);
|
|
1485
1485
|
var cwdEntry = { path: cwd, slug: slug, addedAt: Date.now() };
|
|
1486
|
-
// Restore title/icon from .
|
|
1486
|
+
// Restore title/icon from .clagentic-rc if available
|
|
1487
1487
|
var cwdRc = loadClayrc();
|
|
1488
1488
|
var cwdRecent = cwdRc.recentProjects || [];
|
|
1489
1489
|
for (var cr = 0; cr < cwdRecent.length; cr++) {
|
|
@@ -1501,7 +1501,7 @@ async function forkDaemon(mode, keepAwake, extraProjects, addCwd, wantOsUsers) {
|
|
|
1501
1501
|
usedSlugs.push(slug);
|
|
1502
1502
|
}
|
|
1503
1503
|
|
|
1504
|
-
// Add restored projects (from ~/.
|
|
1504
|
+
// Add restored projects (from ~/.clagentic-rc)
|
|
1505
1505
|
if (extraProjects && extraProjects.length > 0) {
|
|
1506
1506
|
for (var ep = 0; ep < extraProjects.length; ep++) {
|
|
1507
1507
|
var rp = extraProjects[ep];
|
|
@@ -1603,7 +1603,6 @@ async function forkDaemon(mode, keepAwake, extraProjects, addCwd, wantOsUsers) {
|
|
|
1603
1603
|
: protocol + "://" + ip + ":" + config.port;
|
|
1604
1604
|
console.log(" " + sym.done + " Daemon started (PID " + config.pid + ")");
|
|
1605
1605
|
console.log(" " + sym.done + " " + url);
|
|
1606
|
-
if (config.builtinCert) console.log(" " + sym.done + " d.clay.studio provides HTTPS certificates only. Your traffic never leaves your network.");
|
|
1607
1606
|
if (config.mkcertDetected) console.log(" " + sym.warn + " Clay now ships with a builtin HTTPS certificate. To use it, pass --builtin-cert or uninstall mkcert.");
|
|
1608
1607
|
if (_pendingSetupCode) {
|
|
1609
1608
|
console.log("");
|
|
@@ -1662,7 +1661,7 @@ async function devMode(mode, keepAwake, existingPinHash, wantOsUsers) {
|
|
|
1662
1661
|
var restorable = (rc.recentProjects || []).filter(function (p) {
|
|
1663
1662
|
return p.path !== cwd && fs.existsSync(p.path);
|
|
1664
1663
|
});
|
|
1665
|
-
// Restore title/icon for cwd from .
|
|
1664
|
+
// Restore title/icon for cwd from .clagentic-rc
|
|
1666
1665
|
var rcAll = rc.recentProjects || [];
|
|
1667
1666
|
for (var ci = 0; ci < rcAll.length; ci++) {
|
|
1668
1667
|
if (rcAll[ci].path === cwd) {
|
|
@@ -1964,8 +1963,7 @@ function showMainMenu(config, ip, setupCode) {
|
|
|
1964
1963
|
|
|
1965
1964
|
function afterQr() {
|
|
1966
1965
|
// Status line
|
|
1967
|
-
log(" " + a.dim + "
|
|
1968
|
-
if (config.builtinCert) log(" " + a.dim + "d.clay.studio provides HTTPS certificates only. Your traffic never leaves your network." + a.reset);
|
|
1966
|
+
log(" " + a.dim + "clagentic" + a.reset + " " + a.dim + "v" + currentVersion + a.reset + a.dim + " — " + url + a.reset);
|
|
1969
1967
|
var parts = [];
|
|
1970
1968
|
parts.push(a.bold + projs.length + a.reset + a.dim + (projs.length === 1 ? " project" : " projects"));
|
|
1971
1969
|
parts.push(a.reset + a.bold + totalSessions + a.reset + a.dim + (totalSessions === 1 ? " session" : " sessions"));
|
|
@@ -2045,16 +2043,14 @@ function showMainMenu(config, ip, setupCode) {
|
|
|
2045
2043
|
}
|
|
2046
2044
|
}, {
|
|
2047
2045
|
hint: [
|
|
2048
|
-
"Run npx @clagentic/console in other directories to add more projects.",
|
|
2049
|
-
"★ github.com/chadbyte/clay — Press s to star the repo",
|
|
2050
|
-
],
|
|
2046
|
+
"Run npx @clagentic/console in other directories to add more projects.", ],
|
|
2051
2047
|
keys: [
|
|
2052
2048
|
{ key: "o", onKey: function () {
|
|
2053
2049
|
openUrl(url);
|
|
2054
2050
|
showMainMenu(config, ip);
|
|
2055
2051
|
}},
|
|
2056
2052
|
{ key: "s", onKey: function () {
|
|
2057
|
-
openUrl("https://github.com/
|
|
2053
|
+
openUrl("https://github.com/clagentic/clagentic-console");
|
|
2058
2054
|
showMainMenu(config, ip);
|
|
2059
2055
|
}},
|
|
2060
2056
|
],
|
|
@@ -2659,7 +2655,6 @@ var currentVersion = require("../package.json").version;
|
|
|
2659
2655
|
: protocol + "://" + ip + ":" + config.port;
|
|
2660
2656
|
console.log(" " + sym.done + " Daemon already running (PID " + config.pid + ")");
|
|
2661
2657
|
console.log(" " + sym.done + " " + url);
|
|
2662
|
-
if (config.builtinCert) console.log(" " + sym.done + " d.clay.studio provides HTTPS certificates only. Your traffic never leaves your network.");
|
|
2663
2658
|
process.exit(0);
|
|
2664
2659
|
return;
|
|
2665
2660
|
}
|
|
@@ -2781,7 +2776,7 @@ var currentVersion = require("../package.json").version;
|
|
|
2781
2776
|
if (autoRestorable.length > 0 && autoYes) {
|
|
2782
2777
|
console.log(" " + sym.done + " Restoring " + autoRestorable.length + " previous project(s)");
|
|
2783
2778
|
}
|
|
2784
|
-
// Add cwd if it has history in .
|
|
2779
|
+
// Add cwd if it has history in .clagentic-rc, or if there are no other projects to restore
|
|
2785
2780
|
var cwdInRc = (autoRc.recentProjects || []).some(function (p) {
|
|
2786
2781
|
return p.path === cwd;
|
|
2787
2782
|
});
|
|
@@ -2790,7 +2785,7 @@ var currentVersion = require("../package.json").version;
|
|
|
2790
2785
|
} else {
|
|
2791
2786
|
// First run: interactive wizard
|
|
2792
2787
|
setup(function (mode, keepAwake, wantOsUsers) {
|
|
2793
|
-
// Check ~/.
|
|
2788
|
+
// Check ~/.clagentic-rc for previous projects to restore
|
|
2794
2789
|
var rc = loadClayrc();
|
|
2795
2790
|
var restorable = (rc.recentProjects || []).filter(function (p) {
|
|
2796
2791
|
return p.path !== cwd && fs.existsSync(p.path);
|
package/lib/agents-favorites.js
CHANGED
package/lib/config.js
CHANGED
package/lib/crisis-safety.js
CHANGED
package/lib/daemon.js
CHANGED
|
@@ -48,6 +48,14 @@ console.log("[daemon] Users: " + usersModule.USERS_FILE);
|
|
|
48
48
|
if (process.env.SUDO_USER) console.log("[daemon] SUDO_USER: " + process.env.SUDO_USER);
|
|
49
49
|
console.log("[daemon] UID: " + (typeof process.getuid === "function" ? process.getuid() : "N/A"));
|
|
50
50
|
|
|
51
|
+
|
|
52
|
+
// --- Single-user migration hint ---
|
|
53
|
+
if (config.pinHash && !usersModule.isMultiUser()) {
|
|
54
|
+
var userData = usersModule.loadUsers();
|
|
55
|
+
if (userData.users.length === 0) {
|
|
56
|
+
console.log("[daemon] Single-user PIN mode active. Visit Settings → Users to migrate to multi-user mode.");
|
|
57
|
+
}
|
|
58
|
+
}
|
|
51
59
|
// --- OS users mode: check required system dependencies ---
|
|
52
60
|
if (config.osUsers) {
|
|
53
61
|
var checkExec = require("child_process").execFileSync;
|
|
@@ -183,7 +191,21 @@ var relay = createServer({
|
|
|
183
191
|
if (config.osUsers) {
|
|
184
192
|
baseDir = "/var/clagentic/projects";
|
|
185
193
|
} else {
|
|
186
|
-
baseDir = config.projectsDir ||
|
|
194
|
+
baseDir = config.projectsDir || (function () {
|
|
195
|
+
var newDir = path.join(REAL_HOME, "clagentic-projects");
|
|
196
|
+
var oldDir = path.join(REAL_HOME, "clay-projects");
|
|
197
|
+
// One-time migration: if new dir absent but old dir exists, rename it
|
|
198
|
+
if (!fs.existsSync(newDir) && fs.existsSync(oldDir)) {
|
|
199
|
+
try {
|
|
200
|
+
fs.renameSync(oldDir, newDir);
|
|
201
|
+
console.log("[config] Renamed " + oldDir + " → " + newDir);
|
|
202
|
+
} catch (e) {
|
|
203
|
+
// rename failed (e.g. cross-device) — fall back to old dir to avoid data loss
|
|
204
|
+
return oldDir;
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
return newDir;
|
|
208
|
+
})();
|
|
187
209
|
}
|
|
188
210
|
try { fs.mkdirSync(baseDir, { recursive: true }); } catch (e) {}
|
|
189
211
|
// Generate slug and deduplicate
|
|
@@ -253,7 +275,21 @@ var relay = createServer({
|
|
|
253
275
|
if (config.osUsers) {
|
|
254
276
|
baseDir = "/var/clagentic/projects";
|
|
255
277
|
} else {
|
|
256
|
-
baseDir = config.projectsDir ||
|
|
278
|
+
baseDir = config.projectsDir || (function () {
|
|
279
|
+
var newDir = path.join(REAL_HOME, "clagentic-projects");
|
|
280
|
+
var oldDir = path.join(REAL_HOME, "clay-projects");
|
|
281
|
+
// One-time migration: if new dir absent but old dir exists, rename it
|
|
282
|
+
if (!fs.existsSync(newDir) && fs.existsSync(oldDir)) {
|
|
283
|
+
try {
|
|
284
|
+
fs.renameSync(oldDir, newDir);
|
|
285
|
+
console.log("[config] Renamed " + oldDir + " → " + newDir);
|
|
286
|
+
} catch (e) {
|
|
287
|
+
// rename failed (e.g. cross-device) — fall back to old dir to avoid data loss
|
|
288
|
+
return oldDir;
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
return newDir;
|
|
292
|
+
})();
|
|
257
293
|
}
|
|
258
294
|
try { fs.mkdirSync(baseDir, { recursive: true }); } catch (e) {}
|
|
259
295
|
// Derive slug from repo URL
|
package/lib/dm.js
CHANGED
package/lib/mcp-local.js
CHANGED
package/lib/os-users.js
CHANGED