@albion-labs/cli
v0.1.0
Published
Albion local agent: mirrors your terminals to an Albion canvas. Source-available; only ever mirrors PTY bytes -- never touches your AI login.
Readme
@albion-labs/cli
The Albion local agent. Runs on your machine, spawns/wraps PTYs (node-pty), and
mirrors terminal bytes to the relay over outbound-only WSS. The installed
command is albion (albion run / albion share / albion daemon).
Trust stance (D4/D13): source-available from day one; mirrors bytes of your own official CLI sessions; never automates, proxies, or stores your AI-provider login.
npm name (D31, 09/07/26): bare albion and albion-cli are squatted, so the
package lives under the claimed org scope — @albion-labs/cli — with bin
albion (what users type is unaffected by the registry name). Stage 0: skeleton + the node-pty
spawn-helper postinstall guard (see spikes/spike-a/OUTCOME.md).
Environment
| Var | Meaning | Default |
|---|---|---|
| ALBION_RELAY | Relay WebSocket base (same as --relay) | ws://localhost:3200 |
| ALBION_USER | Albion identity (same as --user) | william |
WEPO_RELAY / WEPO_USER are deprecated fallbacks from the pre-rename era:
still read for one release (a one-time warning is printed), removed after that.
Flags beat env vars; env vars beat defaults.
Publishing
Publish from the repo root with pnpm (never npm publish from this
directory — npm does not rewrite the workspace:* dependency on
@albion-labs/shared, so the tarball would be uninstallable):
pnpm run release:cli # publishes @albion-labs/shared, then @albion-labs/clipnpm rewrites workspace:* to the real version at pack time and refuses to
publish from a dirty tree. On later releases, bump BOTH package versions (or at
least every package whose version is already on the registry) before running the
script — publishing an already-published version fails and the && chain stops
there. Licence remains UNLICENSED (all rights reserved) until William picks
the source-available licence text — publishing under it is deliberate: source
visible, no licence granted yet.
