ghostterm 1.0.1 → 1.0.2

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 +82 -29
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,36 @@
1
- # GhostTerm
1
+ # GhostTerm 👻
2
2
 
3
- A mobile terminal for Claude Code fans. Control your PC terminal from your phone — no VPN, no Tailscale, just works.
3
+ **A mobile terminal for Claude Code fans.** Control your PC from your phone — real CLI, not a toy.
4
+
5
+ > *GhostTerm is not affiliated with Anthropic. Just a fan who couldn't stop using Claude Code.*
6
+
7
+ ---
8
+
9
+ ## Why GhostTerm?
10
+
11
+ You're running Claude Code on your PC. You walk away. Now what?
12
+
13
+ - **Monitor from your phone** — watch Claude Code work in real-time
14
+ - **Approve permissions** — tap Yes/No from your couch
15
+ - **Run `--dangerously-skip-permissions`** — let Claude go full auto, monitor from your phone while it codes for you
16
+ - **4 terminal sessions at once** — more than Anthropic's official app
17
+ - **Real xterm.js terminal** — not a dumbed-down GUI, full ANSI colors, scrollback, the works
18
+
19
+ ## Demo
20
+
21
+ ```
22
+ ╔═══════════════════════════════════╗
23
+ ║ GhostTerm Companion ║
24
+ ║ Mobile terminal for Claude Code ║
25
+ ╚═══════════════════════════════════╝
26
+
27
+ Using cached Google login
28
+ Connected to relay
29
+ Authenticated as: you@gmail.com
30
+ Phone will auto-connect with same Google account
31
+ Mobile connected!
32
+ Terminal 1 spawned (PID: 12345)
33
+ ```
4
34
 
5
35
  ## Quick Start
6
36
 
@@ -10,54 +40,77 @@ A mobile terminal for Claude Code fans. Control your PC terminal from your phone
10
40
  npx ghostterm
11
41
  ```
12
42
 
13
- First time: a browser will open for Google sign-in. After that, it auto-connects.
43
+ First run opens a browser for Google sign-in. After that, it remembers you.
14
44
 
15
45
  ### 2. On your phone
16
46
 
17
- Open **[ghostterm.pages.dev](https://ghostterm.pages.dev)** and sign in with the same Google account. Your terminal connects automatically.
47
+ Open **[ghostterm.pages.dev](https://ghostterm.pages.dev)** — sign in with the same Google account.
18
48
 
19
- No Google account? Use the 6-digit pairing code shown in your terminal instead.
49
+ That's it. Your terminal appears on your phone. No VPN. No Tailscale. No port forwarding.
20
50
 
21
- ## Features
51
+ ## Use Cases
22
52
 
23
- - Real CLI terminal (not a GUI wrapper)
24
- - Up to 4 terminal sessions simultaneously
25
- - Works on any phone browser — iOS & Android
26
- - Auto-reconnect on disconnect
27
- - Screenshot & file upload to PC
28
- - Google account auto-pairing (no codes needed)
53
+ ### 🔥 The "Dangerous" Workflow
29
54
 
30
- ## Requirements
55
+ ```bash
56
+ claude --dangerously-skip-permissions
57
+ ```
31
58
 
32
- - **PC**: Node.js 18+ with build tools for native modules
33
- - Windows: `npm install --global windows-build-tools`
34
- - macOS: `xcode-select --install`
35
- - Linux: `apt install build-essential`
36
- - **Phone**: Any modern browser
59
+ Let Claude Code run fully autonomous on your PC. Monitor everything from your phone. Intervene when needed. Go make coffee.
37
60
 
38
- ## Environment Variables
61
+ ### 🖥️ Multi-Session Power
39
62
 
40
- | Variable | Default | Description |
63
+ 4 ghost cells = 4 terminals. Run Claude Code in one, `git log` in another, `npm test` in a third. Switch between them with a tap.
64
+
65
+ ### 📱 On-the-Go Approval
66
+
67
+ Claude Code asking "May I edit server.js?" — approve it from the bus. No need to rush back to your desk.
68
+
69
+ ### 📸 Screenshot & Upload
70
+
71
+ Take a screenshot of your phone screen and send it to your PC terminal. Upload files directly from your phone to your desktop.
72
+
73
+ ## Features
74
+
75
+ | Feature | GhostTerm | Anthropic Mobile |
41
76
  |---|---|---|
42
- | `GHOSTTERM_RELAY` | `wss://ghostterm-relay.fly.dev` | Custom relay server URL |
77
+ | Real CLI terminal | ✅ | ❌ |
78
+ | Simultaneous sessions | 4 | 1 |
79
+ | Works without VPN | ✅ | N/A |
80
+ | `--dangerously-skip-permissions` monitoring | ✅ | ❌ |
81
+ | File upload to PC | ✅ | ❌ |
82
+ | Auto-reconnect | ✅ | - |
83
+ | Google account pairing | ✅ | - |
84
+
85
+ ## Pricing
86
+
87
+ - **Free**: 1 hour/day, full features
88
+ - **Pro**: NT$168/month — unlimited access
43
89
 
44
90
  ## How It Works
45
91
 
46
92
  ```
47
- Phone (browser) ──WSS──▶ Relay (Fly.io) ◀──WSS── PC (ghostterm)
48
- auto-pairs by
49
- Google account
93
+ Phone (browser) ──WSS──▶ Relay (Fly.io Tokyo) ◀──WSS── PC (ghostterm)
94
+ encrypted WebSocket
95
+ auto-pairs by Google account
96
+ zero data stored
50
97
  ```
51
98
 
52
- Your phone and PC connect to a relay server. Terminal I/O is forwarded in real-time over encrypted WebSocket. No data is stored on the relay.
99
+ All traffic is encrypted (WSS). The relay only forwards messages — no terminal data is stored.
53
100
 
54
- ## Pro
101
+ ## Requirements
55
102
 
56
- Free: 1 hour/day. Upgrade for unlimited access.
103
+ - **PC**: Node.js 18+
104
+ - Windows: may need `npm install -g windows-build-tools`
105
+ - macOS: `xcode-select --install`
106
+ - Linux: `apt install build-essential`
107
+ - **Phone**: Any modern browser (iOS Safari, Chrome, etc.)
57
108
 
58
- ## Disclaimer
109
+ ## Environment Variables
59
110
 
60
- GhostTerm is not affiliated with Anthropic. This is an independent fan project.
111
+ | Variable | Default | Description |
112
+ |---|---|---|
113
+ | `GHOSTTERM_RELAY` | `wss://ghostterm-relay.fly.dev` | Custom relay server URL |
61
114
 
62
115
  ## License
63
116
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ghostterm",
3
- "version": "1.0.1",
3
+ "version": "1.0.2",
4
4
  "description": "Mobile terminal for Claude Code — control your PC from your phone",
5
5
  "bin": {
6
6
  "ghostterm": "bin/ghostterm.js"