@aiiware/aii 0.27.3 → 0.27.5

package/README.md

@@ -426,6 +426,10 @@ Extensible instruction packages you can install and invoke:
 
 Install accepts GitHub refs in any format — a bare `owner/repo` (Aii finds the skill, whether it's at the repo root or in a subdirectory, e.g. `aii skill install tt-a1i/archify`), explicit repo paths, blob URLs, and tree URLs. Every install pins the commit SHA, fetches binaries intact, and shows a trust preview (name, license, script payload) before anything is written. Since v0.24, `--yes` does **not** authorise installing third-party code — in scripts, pass `--trust-source` to confirm you trust the source. Create your own skills in `.aii/skills/<name>/SKILL.md` with YAML frontmatter. Skills in the cross-tool `~/.agents/skills/` directory are shown once before their first run, since other tools can write there.
 
+Project skills are also discovered in `.agents/skills/<name>/SKILL.md`. Both project skill roots require first-use content approval and are disabled by `--no-project-config`. Run `/skill reload` after adding or editing skills.
+
+For matching names, priority is: project commands → project `.aii/skills/` → project `.agents/skills/` → user `~/.aii/skills/` → active persona → plugin → shared `~/.agents/skills/` → built-in → remote. User skills override persona and plugin defaults. Project commands conflicting with protected built-in, persona, plugin, shared or remote skills are ignored; explicit source/plugin IDs remain available.
+
 ### Project Instructions (AGENTS.md)
 
 Drop an `AGENTS.md` file in your project root to give the agent project-specific context — coding conventions, architecture notes, preferred patterns. It's loaded automatically.
@@ -533,6 +537,21 @@ Project slash commands live one markdown file per command under `.aii/commands/`
 
 ---
 
+## Usage analytics
+
+Usage analytics is not active in this build. Telemetry-capable releases enable limited analytics by default for eligible use after showing a notice. Older releases do not upload historical usage. Signals describe launches, setup and request outcomes using random pseudonymous identifiers and broad product metadata; they exclude prompts, responses, files, command arguments, API keys and access tokens.
+
+```bash
+aii telemetry status
+aii telemetry off
+aii telemetry on
+AII_TELEMETRY=off aii
+```
+
+Environment OFF overrides the saved preference and sends nothing. The OFF command saves your choice before new usage requests and may attempt one minimal disable-action receipt for a previously enabled installation. Repeating OFF sends nothing. Previously transmitted requests cannot be recalled and may still arrive. Analytics failures are silent and do not prevent CLI work. Recognized automation and initially Windows are excluded; unavailable safety controls or an undelivered notice also suppress collection.
+
+See the [Privacy Policy](https://aiiware.com/privacy#cli-usage-analytics) for exact data, receipt and retention details, and the [Terms](https://aiiware.com/terms). A release default is distinguished from an explicit ON preference.
+
 ## CLI Reference
 
 | Command | Description |