offhands 0.1.5 → 0.1.9
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/approval-mcp.mjs +189 -10
- package/dist/daemon.mjs +1567 -181
- package/package.json +1 -1
- package/README.internal.md +0 -49
package/package.json
CHANGED
package/README.internal.md
DELETED
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
# offhands — internal README (do not publish)
|
|
2
|
-
|
|
3
|
-
The public npm README is intentionally blank ("Reserved.") until launch —
|
|
4
|
-
founder decision 2026-09-07: stay lowkey, don't hand the idea to copycats.
|
|
5
|
-
This file is the real one; swap it back into README.md at launch.
|
|
6
|
-
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
Drive your coding agents from your phone. `offhands` runs a small daemon on
|
|
10
|
-
your computer that wraps headless agent CLIs (Claude Code today, GitHub
|
|
11
|
-
Copilot CLI, more coming) and pairs with a phone app over an end-to-end
|
|
12
|
-
encrypted relay — the server only ever sees ciphertext.
|
|
13
|
-
|
|
14
|
-
From your phone you can:
|
|
15
|
-
|
|
16
|
-
- start sessions in any workspace and prompt any installed agent
|
|
17
|
-
- **approve or deny risky actions** with a diff preview before they run
|
|
18
|
-
- answer the agent's questions with real option buttons
|
|
19
|
-
- switch model / permission mode / thinking effort mid-session
|
|
20
|
-
- watch context-window usage and per-session cost
|
|
21
|
-
- get receipts (files changed, diffs, screenshots) for every run
|
|
22
|
-
- **drop files and text** between phone and PC, encrypted both ways
|
|
23
|
-
|
|
24
|
-
## Quick start
|
|
25
|
-
|
|
26
|
-
```bash
|
|
27
|
-
cd your-project
|
|
28
|
-
npx offhands
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
Scan the QR it prints with your phone (or open the web app and type the
|
|
32
|
-
code), match the fingerprint shown on both screens, and you're paired.
|
|
33
|
-
|
|
34
|
-
Requires Node 22.5+ and at least one agent CLI installed.
|
|
35
|
-
|
|
36
|
-
## Options
|
|
37
|
-
|
|
38
|
-
```
|
|
39
|
-
offhands [--workspace <path>]... [--dev-url <url>] [--relay <url>]
|
|
40
|
-
[--repair] [--approval-timeout <seconds>] [--local]
|
|
41
|
-
offhands drop <file> # send a file to your paired phone
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
## Security
|
|
45
|
-
|
|
46
|
-
- X25519 key exchange at pairing; all traffic is libsodium secretbox
|
|
47
|
-
- pairing codes are one-time; both screens show a fingerprint to verify
|
|
48
|
-
- the relay stores nothing and can read nothing
|
|
49
|
-
- approvals are enforced in the daemon, not in the UI
|