@astrale-os/cli 1.0.0-beta.26 → 1.0.0-beta.28

package/README.md

@@ -87,12 +87,12 @@ Install the browser driver once:
 
 ```bash
 npm install -g agent-browser && agent-browser install
-npx skills add astrale-os/cli            # installs both the astrale-cli (ops) and astrale-domain (authoring) skills
+npx skills add astrale-os/cli            # installs every Astrale skill published by this repository
 npx skills add vercel-labs/agent-browser
 ```
 
-To install just one: `npx skills add astrale-os/cli@astrale-cli` or
-`npx skills add astrale-os/cli@astrale-domain`.
+To install just one, select `astrale-cli`, `astrale-domain`, `astrale-frontend-design`, or
+`astrale-services`, for example: `npx skills add astrale-os/cli@astrale-frontend-design`.
 
 ## Updating
 
@@ -101,8 +101,11 @@ astrale update --check
 astrale update
 ```
 
-`astrale update` upgrades official script installs and follows the beta channel by default.
-Use `--check`, `--channel <channel>`, or `--version <version>` to control the target release.
+`astrale update` upgrades official script installs, ensures every Astrale agent skill published
+from `astrale-os/cli` is installed and healthy, and follows the beta channel by default. It reports
+whether the skill pass was unchanged, installed, updated, or repaired. Use `--check`,
+`--channel <channel>`, or `--version <version>` to control the CLI release target; skills always
+track the repository's current `main` source. `--no-skills` is the explicit opt-out.
 
 ## Commands
 
@@ -145,6 +148,29 @@ CLI state lives under `~/.astrale/`:
 - `identities.json`
 - keypairs
 - cached IdP sessions
+- `sessions/` — locally recorded work sessions (see below)
+
+### Session retention
+
+Each invocation appends one line to a local session record under
+`~/.astrale/sessions/`; `astrale session list` shows them. The store is swept
+automatically against two bounds — sessions idle past `maxAgeDays` are dropped,
+then the store is trimmed to `maxBytes`, oldest first. Both are optional:
+
+```jsonc
+// ~/.astrale/config.json
+{
+  "telemetry": {
+    "enabled": true,      // false disables recording (the sweep still runs)
+    "maxAgeDays": 30,     // default
+    "maxBytes": 52428800  // default: 50 MB
+  }
+}
+```
+
+`ASTRALE_TELEMETRY_MAX_AGE_DAYS` and `ASTRALE_TELEMETRY_MAX_BYTES` override the
+config for one invocation. Values that are not positive numbers are ignored in
+favour of the default, so a typo cannot leave the store unbounded.
 
 ## Development