@siteboon/claude-code-ui 1.8.12 → 1.9.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/README.md +60 -2
- package/dist/assets/index-Be0ToEQx.js +793 -0
- package/dist/assets/index-Bmo7Hu70.css +32 -0
- package/dist/assets/vendor-codemirror-D2k1L1JZ.js +39 -0
- package/dist/assets/vendor-react-7V_UDHjJ.js +59 -0
- package/dist/assets/vendor-xterm-jI4BCHEb.js +66 -0
- package/dist/clear-cache.html +85 -0
- package/dist/index.html +5 -2
- package/package.json +6 -3
- package/server/claude-sdk.js +513 -0
- package/server/cursor-cli.js +14 -2
- package/server/database/auth.db +0 -0
- package/server/index.js +239 -41
- package/server/projects.js +108 -17
- package/server/routes/commands.js +572 -0
- package/server/utils/commandParser.js +303 -0
- package/dist/assets/index-Cl5xisCA.js +0 -895
- package/dist/assets/index-Co7ALK3i.css +0 -32
- package/server/claude-cli.js +0 -397
package/README.md
CHANGED
|
@@ -67,7 +67,49 @@ No installation required, direct operation:
|
|
|
67
67
|
npx @siteboon/claude-code-ui
|
|
68
68
|
```
|
|
69
69
|
|
|
70
|
-
|
|
70
|
+
The server will start and be accessible at `http://localhost:3001` (or your configured PORT).
|
|
71
|
+
|
|
72
|
+
**To restart**: Simply run the same `npx` command again after stopping the server (Ctrl+C or Cmd+C).
|
|
73
|
+
|
|
74
|
+
### Global Installation (For Regular Use)
|
|
75
|
+
|
|
76
|
+
For frequent use, install globally once:
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
npm install -g @siteboon/claude-code-ui
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
Then start with a simple command:
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
claude-code-ui
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
**Benefits**:
|
|
89
|
+
- Faster startup (no download/cache check)
|
|
90
|
+
- Simple command to remember
|
|
91
|
+
- Same experience every time
|
|
92
|
+
|
|
93
|
+
**To restart**: Stop with Ctrl+C and run `claude-code-ui` again.
|
|
94
|
+
|
|
95
|
+
### Run as Background Service (Optional)
|
|
96
|
+
|
|
97
|
+
To keep the server running in the background, use PM2:
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
# Install PM2 globally (one-time)
|
|
101
|
+
npm install -g pm2
|
|
102
|
+
|
|
103
|
+
# Start the server
|
|
104
|
+
pm2 start claude-code-ui --name "claude-ui"
|
|
105
|
+
|
|
106
|
+
# Manage the service
|
|
107
|
+
pm2 list # View status
|
|
108
|
+
pm2 restart claude-ui # Restart
|
|
109
|
+
pm2 stop claude-ui # Stop
|
|
110
|
+
pm2 logs claude-ui # View logs
|
|
111
|
+
pm2 startup # Auto-start on system boot
|
|
112
|
+
```
|
|
71
113
|
|
|
72
114
|
### Local Development Installation
|
|
73
115
|
|
|
@@ -236,13 +278,29 @@ We welcome contributions! Please follow these guidelines:
|
|
|
236
278
|
|
|
237
279
|
### Common Issues & Solutions
|
|
238
280
|
|
|
281
|
+
#### Server starts but redirects to port 5173 (Vite)
|
|
282
|
+
**Problem**: Running `npx @siteboon/claude-code-ui` says it's running on port 3001, but redirects to 5173
|
|
283
|
+
**Solutions**:
|
|
284
|
+
- This was fixed in v1.9.1+. Update to the latest version:
|
|
285
|
+
```bash
|
|
286
|
+
npx @siteboon/claude-code-ui@latest
|
|
287
|
+
```
|
|
288
|
+
- Or clear NPX cache and reinstall:
|
|
289
|
+
```bash
|
|
290
|
+
npx clear-npx-cache
|
|
291
|
+
npx @siteboon/claude-code-ui
|
|
292
|
+
```
|
|
293
|
+
- If using global install, update it:
|
|
294
|
+
```bash
|
|
295
|
+
npm update -g @siteboon/claude-code-ui
|
|
296
|
+
```
|
|
297
|
+
|
|
239
298
|
#### "No Claude projects found"
|
|
240
299
|
**Problem**: The UI shows no projects or empty project list
|
|
241
300
|
**Solutions**:
|
|
242
301
|
- Ensure [Claude CLI](https://docs.anthropic.com/en/docs/claude-code) is properly installed
|
|
243
302
|
- Run `claude` command in at least one project directory to initialize
|
|
244
303
|
- Verify `~/.claude/projects/` directory exists and has proper permissions
|
|
245
|
-
d
|
|
246
304
|
|
|
247
305
|
#### File Explorer Issues
|
|
248
306
|
**Problem**: Files not loading, permission errors, empty directories
|