wherever-dev 0.19.0 → 0.19.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/CHANGELOG.md +1186 -0
- package/README.md +60 -0
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/package.json +28 -8
- package/public/_app/immutable/assets/0.Be_gG-_m.css +1 -0
- package/public/_app/immutable/assets/SymbolsNerdFontMono-Regular.D4tvPAg7.woff2 +0 -0
- package/public/_app/immutable/chunks/BQPpGHw6.js +2 -0
- package/public/_app/immutable/chunks/{CMMpRRWm.js.map → BQPpGHw6.js.map} +1 -1
- package/public/_app/immutable/chunks/{D7cniAcl.js → DuS4tUIT.js} +2 -2
- package/public/_app/immutable/chunks/{D7cniAcl.js.map → DuS4tUIT.js.map} +1 -1
- package/public/_app/immutable/chunks/{B4u7MCsa.js → DxTGwxLe.js} +2 -2
- package/public/_app/immutable/chunks/{B4u7MCsa.js.map → DxTGwxLe.js.map} +1 -1
- package/public/_app/immutable/entry/{app.B09hP3rk.js → app.D0o7KH5i.js} +3 -3
- package/public/_app/immutable/entry/{app.B09hP3rk.js.map → app.D0o7KH5i.js.map} +1 -1
- package/public/_app/immutable/entry/start.UO7O7dio.js +2 -0
- package/public/_app/immutable/entry/start.UO7O7dio.js.map +1 -0
- package/public/_app/immutable/nodes/{0.Bl6oKVU5.js → 0.QmgixO0O.js} +2 -2
- package/public/_app/immutable/nodes/{0.Bl6oKVU5.js.map → 0.QmgixO0O.js.map} +1 -1
- package/public/_app/immutable/nodes/{1.H6kc-Qsz.js → 1.1znPEWAi.js} +2 -2
- package/public/_app/immutable/nodes/{1.H6kc-Qsz.js.map → 1.1znPEWAi.js.map} +1 -1
- package/public/_app/immutable/nodes/{2.B6sChdvF.js → 2._c_bFISu.js} +2 -2
- package/public/_app/immutable/nodes/{2.B6sChdvF.js.map → 2._c_bFISu.js.map} +1 -1
- package/public/_app/version.json +1 -1
- package/public/index.html +11 -11
- package/public/service-worker.js +1 -1
- package/public/_app/immutable/assets/0.Cb5vRzMp.css +0 -1
- package/public/_app/immutable/chunks/CMMpRRWm.js +0 -2
- package/public/_app/immutable/entry/start.DsunIvKH.js +0 -2
- package/public/_app/immutable/entry/start.DsunIvKH.js.map +0 -1
package/README.md
ADDED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# wherever-dev
|
|
2
|
+
|
|
3
|
+
The standalone server of [Wherever](https://wherever.dev): drive several [pi coding agent](https://pi.dev) sessions from a web dashboard on your phone, tablet or any browser, and keep a terminal `pi` in sync with them.
|
|
4
|
+
|
|
5
|
+
The server runs pi sessions in-process through the pi SDK and serves the web dashboard, so you do not need the `pi` CLI to use it. Install [`@wherever-dev/pi`](https://www.npmjs.com/package/@wherever-dev/pi) into pi as well if you also want terminal sessions mirrored to the dashboard (bridge mode).
|
|
6
|
+
|
|
7
|
+
## Features
|
|
8
|
+
|
|
9
|
+
- Many concurrent sessions across your project folders, created, resumed and forked from the browser.
|
|
10
|
+
- A mobile-first dashboard (installable as a PWA): streaming replies, tool calls, model switching, `!` / `!!` shell commands, file and image uploads, downloads of files the agent attaches.
|
|
11
|
+
- Voice dictation and optional spoken replies.
|
|
12
|
+
- Native MCP: the servers in `~/.pi/agent/mcp.json` are available in web sessions, as in a terminal pi.
|
|
13
|
+
- Live hand-over with a terminal `pi` (through `@wherever-dev/pi`).
|
|
14
|
+
- Runs as a background service (systemd or launchd) with token auth and HTTPS.
|
|
15
|
+
|
|
16
|
+
## Install
|
|
17
|
+
|
|
18
|
+
Requires Node.js 22.19 or later.
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
npm install -g wherever-dev
|
|
22
|
+
wherever start
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Then open `https://localhost:31415`. The server generates a self-signed certificate on first start (this needs `openssl`; without it the server falls back to plain HTTP), so the browser will warn once.
|
|
26
|
+
|
|
27
|
+
To run it as a service that starts with your session and restarts on failure:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
wherever install # per-user systemd unit (Linux) or LaunchAgent (macOS)
|
|
31
|
+
wherever service-status
|
|
32
|
+
wherever uninstall
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
`wherever install` also adds `@wherever-dev/pi` to `~/.pi/agent/settings.json` (skip with `--no-pi-config`).
|
|
36
|
+
|
|
37
|
+
## Common options
|
|
38
|
+
|
|
39
|
+
| Flag | Environment | Default |
|
|
40
|
+
| --- | --- | --- |
|
|
41
|
+
| `--port` | `PI_REMOTE_PORT` | `31415` |
|
|
42
|
+
| `--host` | `PI_REMOTE_HOST` | `127.0.0.1` (use `0.0.0.0` to expose it) |
|
|
43
|
+
| `--token` | `WHEREVER_TOKEN`, `WHEREVER_TOKEN_FILE` | none |
|
|
44
|
+
| `--ssl-key` / `--ssl-cert` | `WHEREVER_SSL_KEY` / `WHEREVER_SSL_CERT` | auto-generated self-signed pair |
|
|
45
|
+
| `--no-ssl` (or `--http`) | `PI_REMOTE_NO_SSL` | HTTPS on |
|
|
46
|
+
| `--idle-timeout` | `PI_IDLE_TIMEOUT` | 20 minutes |
|
|
47
|
+
|
|
48
|
+
Prefer `WHEREVER_TOKEN` or `WHEREVER_TOKEN_FILE` over `--token` on a shared machine: a command line is readable by every user. Open `https://<host>:31415/#token=<token>` once on a device to log it in.
|
|
49
|
+
|
|
50
|
+
## Configuration
|
|
51
|
+
|
|
52
|
+
`~/.wherever/config.json` (override the directory with `WHEREVER_CONFIG_DIR`) holds the rest: preset folders, automatic remote repository creation, uploads, downloads, speech-to-text, the dashboard's per-machine appearance, and `piSdk`, which lets web sessions run on the pi you use in a terminal instead of the bundled SDK.
|
|
53
|
+
|
|
54
|
+
## Documentation
|
|
55
|
+
|
|
56
|
+
The [full documentation](https://github.com/wighawag/wherever#readme) covers every flag and configuration property, reverse proxies and trusted HTTPS (Tailscale, Tunnet), the service's memory limits and `PATH`, updating, and declarative deployment on NixOS.
|
|
57
|
+
|
|
58
|
+
## License
|
|
59
|
+
|
|
60
|
+
[AGPL-3.0-only](https://github.com/wighawag/wherever/blob/main/LICENSE)
|