@ariobarin/glossa 0.1.0-beta.1 → 0.1.0-beta.11

package/LICENSE

@@ -12,4 +12,10 @@ furnished to do so, subject to the following conditions:
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,20 +1,49 @@
-# @ariobarin/glossa
-
-This package contains the `glossa` executable. Install the private beta from npm:
-
-```powershell
-npm install --global @ariobarin/glossa@beta
-glossa login
-glossa status
-glossa whoami
-Set-Location C:\path\to\a\repository
-glossa
-```
-
-Login uses Auth0 Device Authorization Flow. Public tenant, client, and API identifiers are built in, so testers do not configure OAuth values.
-
-OAuth and device credentials use the operating-system credential store. If it is unavailable, Glossa warns before using a restricted credential file.
-
-The first managed session enrolls the computer under its hostname. Running `glossa` inside a Git worktree exposes only that worktree root. The process prints the canonical root, shell authority warning, and write or command activity. Press Ctrl+C to disconnect.
-
-The managed endpoint defaults to `https://mcp.glossa.sh`. Development deployments may override `GLOSSA_RELAY_ORIGIN` and `GLOSSA_WORKER_ORIGIN`. Plain HTTP is accepted only for loopback relay origins and loopback or private IPv4 worker origins.
+# @ariobarin/glossa
+
+This package contains the npm distribution of the `glossa` executable. Node.js
+22.9 or newer is required for this installation method.
+
+The recommended open-beta install on Windows, macOS, and Linux uses npm:
+
+```shell
+npm install --global @ariobarin/glossa@beta
+```
+
+Glossa also provides a self-contained direct installer that does not require
+Node.js or npm.
+
+Windows:
+
+```powershell
+irm https://glossa.sh/install | iex
+```
+
+macOS or Linux:
+
+```shell
+curl -fsSL https://glossa.sh/install.sh | sh
+```
+
+Open a terminal in the repository you want to expose, then run:
+
+```shell
+glossa
+```
+
+The hosted commands run the tracked scripts in `site`. They verify native
+release checksums before installing. Use `glossa update` later with the original
+installation method.
+
+Glossa opens Google sign-in automatically when needed using OAuth Device Authorization Flow. Public client and resource identifiers are built in, so testers do not configure OAuth values. Use the same Google account when authorizing Glossa in ChatGPT.
+
+OAuth and device credentials use the operating-system credential store. If it is unavailable, Glossa warns before using a restricted credential file.
+
+Glossa signs in automatically and exposes the current Git worktree. Pass a directory to expose a different workspace. The live session display shows the connection, authority, and recent activity.
+
+The live display contains the full interactive workflow. Press `s` for account and device status, `r` to revoke a device, `l` to sign out, `u` to update, `d` for recent activity, or `q` or Ctrl+C to disconnect. Press `?` to see the keys at any time.
+
+The same core actions remain available directly with `glossa status`, `glossa devices`, `glossa devices revoke <id>`, `glossa login`, `glossa logout`, and `glossa update`. Status and device listings accept `--json` for scripts.
+
+The managed endpoint defaults to `https://mcp.glossa.sh`. Development deployments may override `GLOSSA_RELAY_ORIGIN` and `GLOSSA_WORKER_ORIGIN`. Plain HTTP is accepted only for loopback relay origins and loopback or private IPv4 worker origins.
+
+Signing out removes local OAuth credentials, opens the browser logout page, and disconnects the current workspace. Other running Glossa sessions remain connected until stopped or revoked.