shellbell 0.0.0-stage → 0.8.0

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 CHANGED
@@ -1,3 +1,32 @@
1
- # Temporary Holding Version
1
+ # shellbell
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Your terminal rings. You answer.: Mac agent for [Shellbell](https://github.com/bilal-/shellbell).
4
+
5
+ Install the headless service with `npm install -g shellbell` (macOS, Node 22+), or download a computer release from [GitHub Releases](https://github.com/bilal-/shellbell/releases). See the [source-install operations guide](https://github.com/bilal-/shellbell/blob/main/docs/install-agent.md).
6
+
7
+ To build from source, from the repository root:
8
+
9
+ ```sh
10
+ corepack enable
11
+ pnpm install --frozen-lockfile
12
+ pnpm -F shellbell build
13
+ node apps/agent/dist/cli.js
14
+ ```
15
+
16
+ Requires macOS and Node 22+. Mirrors iTerm2, tmux (so Ghostty, Warp, Terminal.app, Alacritty,
17
+ Kitty and WezTerm work too) and [Herdr](https://herdr.dev) coding-agent panes, implemented in this checkout.
18
+ iTerm2's Python API (Settings → General → Magic) is only required for the native iTerm2 backend;
19
+ tmux and Herdr require a running local server. Terminal payloads between your phone and this
20
+ agent are end-to-end encrypted; relay control and push metadata are not.
21
+
22
+ A foreground run is not a background installation; the per-user LaunchAgent does not prevent
23
+ sleep. Windows host services remain deferred. Linux archives, installed with the release's one-line `install.sh`, provide tmux-only
24
+ foreground hosting and systemd user-service management. The 0.7.0 archives passed
25
+ isolated Ubuntu 24.04 container checks; native x64 boot and physical phone
26
+ qualification remain open. This npm package declares macOS only; use the Linux
27
+ archives on Linux. See the
28
+ [Linux archive workflow](https://github.com/bilal-/shellbell/blob/main/apps/linux/README.md#operator-workflow)
29
+ and [current qualification](https://github.com/bilal-/shellbell/blob/main/docs/before-first-release.md#qualification-status).
30
+
31
+ See the [service architecture](https://github.com/bilal-/shellbell/blob/main/docs/architecture/README.md)
32
+ for backend capabilities, trust boundaries and known limitations.