ghostterm 1.0.1 → 1.0.3

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 +84 -29
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,37 @@
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
+ ## Screenshots
10
+
11
+ <p align="center">
12
+ <img src="https://ghostterm.pages.dev/img/claude-code.jpg" width="250" alt="Claude Code running on phone">
13
+ <img src="https://ghostterm.pages.dev/img/terminal.jpg" width="250" alt="Terminal with dangerous mode">
14
+ <img src="https://ghostterm.pages.dev/img/pixel-office.jpg" width="250" alt="4 terminal sessions">
15
+ </p>
16
+
17
+ <p align="center">
18
+ <em>Left: Claude Code with <code>--dangerously-skip-permissions</code> running on your phone</em><br>
19
+ <em>Center: Full terminal + custom shortcut keys (y/n, Tab, Ctrl+C, arrows...)</em><br>
20
+ <em>Right: 4 ghost terminals in pixel office view</em>
21
+ </p>
22
+
23
+ ---
24
+
25
+ ## Why GhostTerm?
26
+
27
+ You're running Claude Code on your PC. You walk away. Now what?
28
+
29
+ - **Run `--dangerously-skip-permissions`** — let Claude go full auto, monitor from your phone while it codes for you
30
+ - **4 terminal sessions at once** — more than Anthropic's official app
31
+ - **Real xterm.js terminal** — full ANSI colors, scrollback, not a dumbed-down GUI
32
+ - **Built-in shortcut keys** — `y` / `n` for approvals, `Tab`, `Ctrl+C`, arrow keys, all one-tap
33
+ - **`claude` quick-launch button** — start new sessions, resume, or continue with one tap
34
+ - **Pixel office mode** — see all 4 terminals as cute ghost desks
4
35
 
5
36
  ## Quick Start
6
37
 
@@ -10,54 +41,78 @@ A mobile terminal for Claude Code fans. Control your PC terminal from your phone
10
41
  npx ghostterm
11
42
  ```
12
43
 
13
- First time: a browser will open for Google sign-in. After that, it auto-connects.
44
+ First run opens a browser for Google sign-in. After that, it remembers you.
14
45
 
15
46
  ### 2. On your phone
16
47
 
17
- Open **[ghostterm.pages.dev](https://ghostterm.pages.dev)** and sign in with the same Google account. Your terminal connects automatically.
48
+ Open **[ghostterm.pages.dev](https://ghostterm.pages.dev)** sign in with the same Google account.
18
49
 
19
- No Google account? Use the 6-digit pairing code shown in your terminal instead.
50
+ That's it. Your terminal appears on your phone. No VPN. No Tailscale. No port forwarding.
20
51
 
21
- ## Features
52
+ ## Use Cases
22
53
 
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)
54
+ ### 🔥 The "Dangerous" Workflow
29
55
 
30
- ## Requirements
56
+ ```bash
57
+ claude --dangerously-skip-permissions
58
+ ```
31
59
 
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
60
+ Let Claude Code run fully autonomous on your PC. Monitor everything from your phone. Intervene when needed. Go make coffee.
37
61
 
38
- ## Environment Variables
62
+ ### 🖥️ Multi-Session Power
39
63
 
40
- | Variable | Default | Description |
64
+ 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.
65
+
66
+ ### 📱 On-the-Go Approval
67
+
68
+ Claude Code asking "May I edit server.js?" — tap `y` from the bus. No need to rush back to your desk.
69
+
70
+ ### 📸 Screenshot & Upload
71
+
72
+ Take a screenshot of your phone screen and send it to your PC terminal. Upload files directly from your phone to your desktop.
73
+
74
+ ## Features
75
+
76
+ | Feature | GhostTerm | Anthropic Mobile |
41
77
  |---|---|---|
42
- | `GHOSTTERM_RELAY` | `wss://ghostterm-relay.fly.dev` | Custom relay server URL |
78
+ | Real CLI terminal | | |
79
+ | Simultaneous sessions | 4 | 1 |
80
+ | `--dangerously-skip-permissions` | ✅ monitor from phone | ❌ |
81
+ | Custom shortcut keys | ✅ y/n/Tab/Ctrl+C | ❌ |
82
+ | Pixel office view | ✅ | ❌ |
83
+ | File upload to PC | ✅ | ❌ |
84
+ | No VPN needed | ✅ | N/A |
85
+ | Google auto-pairing | ✅ | - |
86
+
87
+ ## Pricing
88
+
89
+ - **Free**: 1 hour/day, full features
90
+ - **Pro**: NT$168/month — unlimited access
43
91
 
44
92
  ## How It Works
45
93
 
46
94
  ```
47
- Phone (browser) ──WSS──▶ Relay (Fly.io) ◀──WSS── PC (ghostterm)
48
- auto-pairs by
49
- Google account
95
+ Phone (browser) ──WSS──▶ Relay (Fly.io Tokyo) ◀──WSS── PC (ghostterm)
96
+ encrypted WebSocket
97
+ auto-pairs by Google account
98
+ zero data stored
50
99
  ```
51
100
 
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.
101
+ All traffic is encrypted (WSS). The relay only forwards messages no terminal data is stored.
53
102
 
54
- ## Pro
103
+ ## Requirements
55
104
 
56
- Free: 1 hour/day. Upgrade for unlimited access.
105
+ - **PC**: Node.js 18+
106
+ - Windows: may need `npm install -g windows-build-tools`
107
+ - macOS: `xcode-select --install`
108
+ - Linux: `apt install build-essential`
109
+ - **Phone**: Any modern browser (iOS Safari, Chrome, etc.)
57
110
 
58
- ## Disclaimer
111
+ ## Environment Variables
59
112
 
60
- GhostTerm is not affiliated with Anthropic. This is an independent fan project.
113
+ | Variable | Default | Description |
114
+ |---|---|---|
115
+ | `GHOSTTERM_RELAY` | `wss://ghostterm-relay.fly.dev` | Custom relay server URL |
61
116
 
62
117
  ## License
63
118
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ghostterm",
3
- "version": "1.0.1",
3
+ "version": "1.0.3",
4
4
  "description": "Mobile terminal for Claude Code — control your PC from your phone",
5
5
  "bin": {
6
6
  "ghostterm": "bin/ghostterm.js"