ghostterm 1.0.0 → 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.
- package/README.md +117 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
# GhostTerm 👻
|
|
2
|
+
|
|
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
|
+
```
|
|
34
|
+
|
|
35
|
+
## Quick Start
|
|
36
|
+
|
|
37
|
+
### 1. On your PC
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
npx ghostterm
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
First run opens a browser for Google sign-in. After that, it remembers you.
|
|
44
|
+
|
|
45
|
+
### 2. On your phone
|
|
46
|
+
|
|
47
|
+
Open **[ghostterm.pages.dev](https://ghostterm.pages.dev)** — sign in with the same Google account.
|
|
48
|
+
|
|
49
|
+
That's it. Your terminal appears on your phone. No VPN. No Tailscale. No port forwarding.
|
|
50
|
+
|
|
51
|
+
## Use Cases
|
|
52
|
+
|
|
53
|
+
### 🔥 The "Dangerous" Workflow
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
claude --dangerously-skip-permissions
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Let Claude Code run fully autonomous on your PC. Monitor everything from your phone. Intervene when needed. Go make coffee.
|
|
60
|
+
|
|
61
|
+
### 🖥️ Multi-Session Power
|
|
62
|
+
|
|
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 |
|
|
76
|
+
|---|---|---|
|
|
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
|
|
89
|
+
|
|
90
|
+
## How It Works
|
|
91
|
+
|
|
92
|
+
```
|
|
93
|
+
Phone (browser) ──WSS──▶ Relay (Fly.io Tokyo) ◀──WSS── PC (ghostterm)
|
|
94
|
+
encrypted WebSocket
|
|
95
|
+
auto-pairs by Google account
|
|
96
|
+
zero data stored
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
All traffic is encrypted (WSS). The relay only forwards messages — no terminal data is stored.
|
|
100
|
+
|
|
101
|
+
## Requirements
|
|
102
|
+
|
|
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.)
|
|
108
|
+
|
|
109
|
+
## Environment Variables
|
|
110
|
+
|
|
111
|
+
| Variable | Default | Description |
|
|
112
|
+
|---|---|---|
|
|
113
|
+
| `GHOSTTERM_RELAY` | `wss://ghostterm-relay.fly.dev` | Custom relay server URL |
|
|
114
|
+
|
|
115
|
+
## License
|
|
116
|
+
|
|
117
|
+
MIT
|