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.
Files changed (30) hide show
  1. package/CHANGELOG.md +1186 -0
  2. package/README.md +60 -0
  3. package/dist/index.js +1 -0
  4. package/dist/index.js.map +1 -1
  5. package/package.json +28 -8
  6. package/public/_app/immutable/assets/0.Be_gG-_m.css +1 -0
  7. package/public/_app/immutable/assets/SymbolsNerdFontMono-Regular.D4tvPAg7.woff2 +0 -0
  8. package/public/_app/immutable/chunks/BQPpGHw6.js +2 -0
  9. package/public/_app/immutable/chunks/{CMMpRRWm.js.map → BQPpGHw6.js.map} +1 -1
  10. package/public/_app/immutable/chunks/{D7cniAcl.js → DuS4tUIT.js} +2 -2
  11. package/public/_app/immutable/chunks/{D7cniAcl.js.map → DuS4tUIT.js.map} +1 -1
  12. package/public/_app/immutable/chunks/{B4u7MCsa.js → DxTGwxLe.js} +2 -2
  13. package/public/_app/immutable/chunks/{B4u7MCsa.js.map → DxTGwxLe.js.map} +1 -1
  14. package/public/_app/immutable/entry/{app.B09hP3rk.js → app.D0o7KH5i.js} +3 -3
  15. package/public/_app/immutable/entry/{app.B09hP3rk.js.map → app.D0o7KH5i.js.map} +1 -1
  16. package/public/_app/immutable/entry/start.UO7O7dio.js +2 -0
  17. package/public/_app/immutable/entry/start.UO7O7dio.js.map +1 -0
  18. package/public/_app/immutable/nodes/{0.Bl6oKVU5.js → 0.QmgixO0O.js} +2 -2
  19. package/public/_app/immutable/nodes/{0.Bl6oKVU5.js.map → 0.QmgixO0O.js.map} +1 -1
  20. package/public/_app/immutable/nodes/{1.H6kc-Qsz.js → 1.1znPEWAi.js} +2 -2
  21. package/public/_app/immutable/nodes/{1.H6kc-Qsz.js.map → 1.1znPEWAi.js.map} +1 -1
  22. package/public/_app/immutable/nodes/{2.B6sChdvF.js → 2._c_bFISu.js} +2 -2
  23. package/public/_app/immutable/nodes/{2.B6sChdvF.js.map → 2._c_bFISu.js.map} +1 -1
  24. package/public/_app/version.json +1 -1
  25. package/public/index.html +11 -11
  26. package/public/service-worker.js +1 -1
  27. package/public/_app/immutable/assets/0.Cb5vRzMp.css +0 -1
  28. package/public/_app/immutable/chunks/CMMpRRWm.js +0 -2
  29. package/public/_app/immutable/entry/start.DsunIvKH.js +0 -2
  30. 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)
package/dist/index.js CHANGED
@@ -40,6 +40,7 @@ const MIME_TYPES = {
40
40
  '.jpeg': 'image/jpeg',
41
41
  '.gif': 'image/gif',
42
42
  '.svg': 'image/svg+xml',
43
+ '.woff2': 'font/woff2',
43
44
  '.ico': 'image/x-icon',
44
45
  '.wasm': 'application/wasm',
45
46
  '.txt': 'text/plain',