shellbell 0.0.0-stage → 0.7.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,31 @@
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
+ Public npm installation is not available yet. Use a source checkout, or a computer preview 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
+ 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 preview archives provide tmux-only foreground hosting and systemd user-service
24
+ management. The published 0.3.0 archives passed isolated Ubuntu 22.04/24.04 container
25
+ checks; native x64 boot and physical phone qualification remain open. This package still declares macOS;
26
+ the commands above are not a qualified Linux package-install recipe. See the
27
+ [Linux archive workflow](https://github.com/bilal-/shellbell/blob/main/apps/linux/README.md#operator-workflow)
28
+ and [current qualification](https://github.com/bilal-/shellbell/blob/main/docs/before-first-release.md#qualification-status).
29
+
30
+ See the [service architecture](https://github.com/bilal-/shellbell/blob/main/docs/architecture/README.md)
31
+ for backend capabilities, trust boundaries and known limitations.