claude-remote-cli 2.4.3 → 2.4.5
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
CHANGED
|
@@ -2,6 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
Remote web interface for interacting with Claude Code CLI sessions from any device.
|
|
4
4
|
|
|
5
|
+
## Prerequisites
|
|
6
|
+
|
|
7
|
+
| Dependency | Why |
|
|
8
|
+
|------------|-----|
|
|
9
|
+
| **[Node.js 24+](https://nodejs.org/)** | Runtime for the server |
|
|
10
|
+
| **[Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)** | The CLI that powers each terminal session — must be in your `PATH` |
|
|
11
|
+
| **[GitHub CLI (`gh`)](https://cli.github.com/)** | *Optional* — required for the **PRs tab**. Run `gh auth login` after installing. |
|
|
12
|
+
|
|
5
13
|
## Getting Started
|
|
6
14
|
|
|
7
15
|
### 1. Install
|
|
@@ -10,8 +18,6 @@ Remote web interface for interacting with Claude Code CLI sessions from any devi
|
|
|
10
18
|
npm install -g claude-remote-cli
|
|
11
19
|
```
|
|
12
20
|
|
|
13
|
-
Requires **Node.js 24+** and **[Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)** installed and available in your PATH.
|
|
14
|
-
|
|
15
21
|
### 2. Start the server
|
|
16
22
|
|
|
17
23
|
```bash
|
|
@@ -142,17 +148,19 @@ The PIN hash is stored in config under `pinHash`. To reset:
|
|
|
142
148
|
## Features
|
|
143
149
|
|
|
144
150
|
- **PIN-protected access** with rate limiting
|
|
145
|
-
- **Repo sessions** —
|
|
151
|
+
- **Repo sessions** — click any idle repo to instantly open Claude with `--continue` (no dialog), or start fresh from the new-session dialog
|
|
146
152
|
- **Branch-aware worktrees** — create worktrees from new or existing branches with a type-to-search branch picker
|
|
147
|
-
- **Tabbed sidebar** — switch between Repos and
|
|
153
|
+
- **Tabbed sidebar** — switch between Repos, Worktrees, and PRs views with shared filters and item counts
|
|
148
154
|
- **Worktree isolation** — each worktree session runs in its own git worktree under `.worktrees/`
|
|
149
155
|
- **Resume sessions** — click inactive worktrees to reconnect with `--continue`
|
|
150
156
|
- **Persistent session names** — display names, branch names, and timestamps survive server restarts
|
|
151
157
|
- **Clipboard image paste** — paste screenshots directly into remote terminal sessions (macOS clipboard + xclip on Linux)
|
|
152
|
-
- **
|
|
153
|
-
- **
|
|
158
|
+
- **Pull requests tab** — view your open PRs (authored and review-requested) per repo via `gh` CLI, with Author/Reviewer filter and one-click session creation from any PR branch
|
|
159
|
+
- **Yolo mode** — skip permission prompts with `--dangerously-skip-permissions` (per-session pill button)
|
|
160
|
+
- **Worktree cleanup** — delete inactive worktrees via the trash pill button (removes worktree, prunes refs, deletes branch)
|
|
154
161
|
- **Sidebar filters** — filter by root directory, repo, or text search
|
|
155
|
-
- **Inline
|
|
162
|
+
- **Inline actions** — pill buttons on session cards for rename, YOLO, worktree creation, and delete (hover on desktop, long-press on mobile)
|
|
163
|
+
- **Resizable sidebar** — drag the sidebar edge to resize; collapse/expand with a button (persisted to localStorage)
|
|
156
164
|
- **Scrollback buffer** — reconnect to a session and see prior output
|
|
157
165
|
- **Touch toolbar** — mobile-friendly buttons for special keys (hidden on desktop)
|
|
158
166
|
- **Responsive layout** — works on desktop and mobile with slide-out sidebar
|
|
@@ -162,7 +170,7 @@ The PIN hash is stored in config under `pinHash`. To reset:
|
|
|
162
170
|
|
|
163
171
|
## Architecture
|
|
164
172
|
|
|
165
|
-
TypeScript + ESM backend compiled to `dist/`.
|
|
173
|
+
TypeScript + ESM backend (Express + node-pty + WebSocket) compiled to `dist/`. Svelte 5 frontend (runes + Vite) compiled to `dist/frontend/`.
|
|
166
174
|
|
|
167
175
|
```
|
|
168
176
|
claude-remote-cli/
|
|
@@ -178,11 +186,13 @@ claude-remote-cli/
|
|
|
178
186
|
│ ├── clipboard.ts # System clipboard operations (image paste)
|
|
179
187
|
│ ├── service.ts # Background service management (launchd/systemd)
|
|
180
188
|
│ └── types.ts # Shared TypeScript interfaces
|
|
181
|
-
├──
|
|
182
|
-
│
|
|
183
|
-
│
|
|
184
|
-
│
|
|
185
|
-
│
|
|
189
|
+
├── frontend/
|
|
190
|
+
│ └── src/
|
|
191
|
+
│ ├── components/ # Svelte 5 components (Sidebar, Terminal, SessionList, etc.)
|
|
192
|
+
│ ├── lib/state/ # Reactive state modules (.svelte.ts)
|
|
193
|
+
│ ├── lib/api.ts # REST API client
|
|
194
|
+
│ ├── lib/ws.ts # WebSocket connection management
|
|
195
|
+
│ └── lib/types.ts # Frontend TypeScript interfaces
|
|
186
196
|
├── test/ # Unit tests (node:test)
|
|
187
197
|
├── dist/ # Compiled output (gitignored)
|
|
188
198
|
├── config.example.json
|