herm-tui 1.9.0-dev.16 → 1.9.0-dev.17

package/README.md

@@ -93,15 +93,49 @@ See [`.env.example`](./.env.example) for rarely-needed overrides.
 
 ### Share and install eikons
 
+Eikons are 48×24 terminal avatars. The shipped lifecycle is deterministic:
+discover, inspect, install, use, update, and remove.
+
+In Herm:
+
 - Open Eikon → Marketplace, or run `/marketplace`, to browse shared catalog
   entries.
-- Preview the selected eikon, install without activating, then use it when
-  ready.
-- Use `eikon.liftaris.dev` as a discovery gallery only; it previews catalog
-  entries and gives copyable Herm install instructions.
-- Submit local non-bundled eikons from Studio with `u`; Herm shows the exact
-  preflight bundle before submission and blocks published marketplace installs
-  from duplicate submission.
+- Preview rows before installing. Trust is shown as `Verified`, `Unverified`,
+  or `Mismatch` beside source and compatibility state.
+- Install adds the eikon to your local library without activating it.
+- Use selects an installed eikon as the active avatar.
+- Update or remove an active eikon only after confirming that the active
+  avatar's backing package will change or be cleared.
+
+From the shell:
+
+```bash
+herm eikon search [query]
+herm eikon inspect <name|github.com/user/repo/eikon-name|dir>
+herm eikon install <name|github.com/user/repo/eikon-name|dir>
+herm eikon use <name>
+herm eikon info <name>
+herm eikon update <name> --active-ok
+herm eikon remove <name> --active-ok
+```
+
+`install` never activates. `use` is the activation action. JSON output is
+available for automation with `--json`.
+
+Default Marketplace installs fetch built package artifacts referenced by the
+catalog, not creator repositories. Direct GitHub installs are for sharing
+outside the default catalog and support both single-package repos and
+multi-eikon catalog repos addressed as `github.com/user/repo/eikon-name`.
+Private GitHub repos use normal git authentication.
+
+Creators can share eikons through normal GitHub repositories. Use upstream
+`eikon pack`, `eikon index`, and `eikon manifest` to prepare single-package or
+multi-eikon repos for direct installs. `eikon publish` remains a GitHub PR
+contribution helper for the configured/default catalog repo; it is not a
+hosted marketplace account, upload, dashboard, or moderation flow.
+
+Use `eikon.liftaris.dev` as a discovery gallery only; it previews catalog
+entries and gives copyable Herm install instructions.
 
 Herm owns native Marketplace behavior. The eikon repo owns the registry,
 browser mirror, shared catalog/player exports, install resolver, and publish

package/assets/eikons/nous/manifest.json

@@ -0,0 +1,120 @@
+{
+  "kind": "eikon.package",
+  "schemaVersion": "1.0",
+  "id": "liftaris/nous",
+  "name": "nous",
+  "version": "1.0.0",
+  "display": {
+    "title": "nous",
+    "author": "kaio",
+    "glyph": "⬡"
+  },
+  "compatibility": {
+    "eikon": ">=1 <2"
+  },
+  "legacy": {
+    "sourceFormat": "pre-launch .eikon draft",
+    "migration": "converted",
+    "notes": [
+      "moved legacy metadata: author, created, source_url"
+    ]
+  },
+  "source": {
+    "base": "blobs/sha256/8c4dc411ca159253cc90fa31f5263799054592e6eaeb4e5c99881c8cac29e67b",
+    "states": {
+      "idle": {
+        "file": "blobs/sha256/481c010826d7cacb9c419455bd0f73d020f66492a1236b37e4e53353b7965902"
+      },
+      "listening": {
+        "file": "blobs/sha256/94f0f4f710c708f516128125142d5dce701f83558e9fad444c1bb376ee3c1fea"
+      },
+      "thinking": {
+        "file": "blobs/sha256/5ae0eb2e1889c72bed69144998acc6f80b9d11b67beffccd972842a9d6ed0f24"
+      },
+      "speaking": {
+        "file": "blobs/sha256/5c15fd3db3fba93b378eb5b23ab9ecf283e8fb5a08828f1393e91b323b65eab2"
+      },
+      "working": {
+        "file": "blobs/sha256/f63a864e84c4b4f672d6b02a4bcf610b2881fcf64166273b29a642fb76e00f09"
+      },
+      "error": {
+        "file": "blobs/sha256/5d1a1fa59ec9091d9c03d99728b15287ef58d397ea2c787a65c55519482683c8"
+      }
+    }
+  },
+  "entrypoints": {
+    "default": "blobs/sha256/b2685743b05ddf201920b69db58640d4fab644e637fa7d313c6dfa215fa41fb7"
+  },
+  "files": [
+    {
+      "path": "blobs/sha256/b2685743b05ddf201920b69db58640d4fab644e637fa7d313c6dfa215fa41fb7",
+      "role": "runtime",
+      "mediaType": "application/vnd.eikon.stream+jsonl",
+      "size": 1401439,
+      "digest": "sha256:b2685743b05ddf201920b69db58640d4fab644e637fa7d313c6dfa215fa41fb7"
+    },
+    {
+      "path": "blobs/sha256/8c4dc411ca159253cc90fa31f5263799054592e6eaeb4e5c99881c8cac29e67b",
+      "role": "source.base",
+      "mediaType": "image/png",
+      "size": 98644,
+      "digest": "sha256:8c4dc411ca159253cc90fa31f5263799054592e6eaeb4e5c99881c8cac29e67b"
+    },
+    {
+      "path": "blobs/sha256/481c010826d7cacb9c419455bd0f73d020f66492a1236b37e4e53353b7965902",
+      "role": "source.clip",
+      "mediaType": "video/mp4",
+      "size": 105789,
+      "digest": "sha256:481c010826d7cacb9c419455bd0f73d020f66492a1236b37e4e53353b7965902",
+      "signal": "state.idle"
+    },
+    {
+      "path": "blobs/sha256/94f0f4f710c708f516128125142d5dce701f83558e9fad444c1bb376ee3c1fea",
+      "role": "source.clip",
+      "mediaType": "video/mp4",
+      "size": 275110,
+      "digest": "sha256:94f0f4f710c708f516128125142d5dce701f83558e9fad444c1bb376ee3c1fea",
+      "signal": "state.listening"
+    },
+    {
+      "path": "blobs/sha256/5ae0eb2e1889c72bed69144998acc6f80b9d11b67beffccd972842a9d6ed0f24",
+      "role": "source.clip",
+      "mediaType": "video/mp4",
+      "size": 174520,
+      "digest": "sha256:5ae0eb2e1889c72bed69144998acc6f80b9d11b67beffccd972842a9d6ed0f24",
+      "signal": "state.thinking"
+    },
+    {
+      "path": "blobs/sha256/5c15fd3db3fba93b378eb5b23ab9ecf283e8fb5a08828f1393e91b323b65eab2",
+      "role": "source.clip",
+      "mediaType": "video/mp4",
+      "size": 96790,
+      "digest": "sha256:5c15fd3db3fba93b378eb5b23ab9ecf283e8fb5a08828f1393e91b323b65eab2",
+      "signal": "state.speaking"
+    },
+    {
+      "path": "blobs/sha256/f63a864e84c4b4f672d6b02a4bcf610b2881fcf64166273b29a642fb76e00f09",
+      "role": "source.clip",
+      "mediaType": "video/mp4",
+      "size": 160072,
+      "digest": "sha256:f63a864e84c4b4f672d6b02a4bcf610b2881fcf64166273b29a642fb76e00f09",
+      "signal": "state.working"
+    },
+    {
+      "path": "blobs/sha256/5d1a1fa59ec9091d9c03d99728b15287ef58d397ea2c787a65c55519482683c8",
+      "role": "source.clip",
+      "mediaType": "video/mp4",
+      "size": 168804,
+      "digest": "sha256:5d1a1fa59ec9091d9c03d99728b15287ef58d397ea2c787a65c55519482683c8",
+      "signal": "state.error"
+    }
+  ],
+  "origin": {
+    "kind": "default-catalog",
+    "source": "https://eikon.liftaris.dev/packages/liftaris/nous/1.0.0.json",
+    "sourceKey": "registry:eikon.liftaris.dev:liftaris/nous@1.0.0",
+    "identityKey": "registry:eikon.liftaris.dev:liftaris/nous@1.0.0",
+    "packageUrl": "https://eikon.liftaris.dev/packages/liftaris/nous/1.0.0.json",
+    "trust": "verified"
+  }
+}

package/assets/eikons/{default/default.eikon → nous/nous.eikon}

@@ -1,4 +1,4 @@
-{"type":"header","eikon":1,"id":"liftaris/default","version":"1.0","title":"Nous","author":{"name":"kaio"},"size":{"cols":48,"rows":24},"defaultSignal":"state.idle","signals":{"state.idle":{"clip":"idle"},"state.listening":{"clip":"listening","fallback":"state.idle"},"state.thinking":{"clip":"thinking","fallback":"state.idle"},"state.speaking":{"clip":"speaking","fallback":"state.idle"},"state.working":{"clip":"working","fallback":"state.idle"},"state.error":{"clip":"error","fallback":"state.idle"}}}
+{"type":"header","eikon":1,"id":"liftaris/nous","version":"1.0.0","title":"nous","author":{"name":"kaio"},"size":{"cols":48,"rows":24},"defaultSignal":"state.idle","signals":{"state.idle":{"clip":"idle"},"state.listening":{"clip":"listening","fallback":"state.idle"},"state.thinking":{"clip":"thinking","fallback":"state.idle"},"state.speaking":{"clip":"speaking","fallback":"state.idle"},"state.working":{"clip":"working","fallback":"state.idle"},"state.error":{"clip":"error","fallback":"state.idle"}}}
 {"type":"clip","name":"idle","fps":16,"frameCount":64,"loopFrom":0}
 {"type":"frame","clip":"idle","index":0,"rows":["⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⣀⣠⣤⣤⣀⣀⣀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⣤⣤⣬⣥⣄⣀⠀⠉⠙⠻⣿⣿⣿⣿⣷⣶⣤⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣤⣾⣿⣿⣿⣿⣿⣿⣿⣿⣷⣦⡀⠀⠈⠻⣿⣿⣿⣿⣿⣿⣷⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⢀⣤⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⡿⢦⡀⠀⠈⢿⣿⣿⣿⣿⣿⢿⡗⠄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⡰⣻⣿⣿⣿⢏⣿⣿⣿⣿⣿⣿⣿⡿⠙⠏⠀⠀⣮⡳⠀⠀⠈⢿⢿⠻⠿⡏⠁⠁⣸⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠌⠈⠉⢺⠻⢃⠊⠙⠛⢠⡀⢀⠙⠁⠁⠀⡘⣶⣷⣿⣷⣾⠀⠀⠈⣶⣆⣳⣶⣮⢔⣿⣿⡆⠀⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⡼⣴⢶⣤⣶⣾⣼⣿⣿⣿⣿⢿⣿⣿⣿⣾⣶⣿⣿⣿⣿⣿⣿⡇⣀⣠⣸⣿⣷⣻⣿⣿⣿⣿⣷⡀⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⢰⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡟⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⢯⣿⣚⣿⣿⣿⢿⣿⣿⣿⣿⣗⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⢿⣿⣿⣿⣿⡘⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⣿⣿⣿⣿⣿⡄⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⡿⠧⠻⠟⣻⠟⡓⠈⠛⠛⠛⠛⠛⠿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣹⣿⣿⣿⣿⣇⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠻⣿⡿⣿⣿⣉⣁⠀⠀⠀⠀⠸⢻⣿⡷⢦⡄⠀⠀⠀⢹⣿⣿⣿⣿⢟⣛⡻⣿⣿⣿⣯⣿⣿⣿⣿⣿⡀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠈⠙⠊⢻⣏⢿⠇⠀⠀⠀⠀⠬⠿⠥⠊⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡼⣿⣿⣿⣿⣇⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⠀⣸⣯⠊⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⢿⣿⣿⣿⣿⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⠀⣿⡇⠠⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡾⣿⣿⣿⣿⡇⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⠀⣿⣇⠰⣄⣄⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⣿⣿⣿⣿⣿⡀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⢰⣿⣿⡆⠣⠄⠈⠁⠀⠀⠀⠀⠀⠀⠀⢠⣿⣿⣿⣿⠻⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣼⣿⣿⢹⣿⣇⠀⠀⠀⠀","⠀⠀⢠⠀⠀⠀⠀⢸⣿⣿⣿⣆⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣿⡏⢈⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠄⣿⣿⡀⠀⠀⠀","⠀⠀⣟⠀⠀⠀⠀⣿⣿⣿⣿⣿⣦⣀⣀⣀⣀⣠⣄⡀⠀⠀⢸⣿⣿⣿⡾⠟⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠁⣹⣿⡇⠐⡄⠀","⠀⢀⣿⣦⣀⣠⣼⣿⣿⣻⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣄⠀⣸⣿⣿⣯⡀⣀⣼⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⢀⣿⣿⡇⠀⣷⠀","⠀⠘⣜⠿⣿⣿⠿⠋⣱⣿⣿⣻⣿⣿⣿⣿⣿⣿⣿⣿⣿⡾⠋⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣣⣾⣿⣿⡇⢠⣿⠀","⠀⠀⠙⠿⣶⣤⣶⣾⣿⣿⢋⣿⣿⣿⣿⣿⣿⣿⣿⠛⢋⡠⢆⠀⠙⠿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⢠⣿⠏⠀","⠀⠀⠀⠀⠀⠉⢯⣉⣉⣡⣾⣿⣿⣿⣿⣿⣿⣿⣿⣧⡀⢋⠝⠃⣀⣴⠟⠫⢛⣭⡿⠚⠋⠉⠁⠒⠫⣝⠻⣿⣿⣿⢟⣵⡿⠋⠀⠀","⠀⠀⠀⠀⠀⠀⠈⠛⠿⠿⠛⢁⣿⣿⣿⣿⣿⣿⣿⣿⣷⣤⡶⠟⠉⠀⢀⣴⡟⠁⠀⠀⠀⠀⠀⠀⠀⠈⠳⣜⢿⡿⠟⠋⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣠⣾⣿⣿⣿⣿⠿⣿⢯⡾⠋⠀⠀⢀⡔⠀⡾⠋⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⠮⠅⠀⠀⠀⠀⠀⠀"]}
 {"type":"frame","clip":"idle","index":1,"rows":["⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣀⣀⣠⣠⣀⣀⣀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣤⣤⣤⣥⣤⣀⠀⠉⠉⠻⢿⣿⣿⣿⣷⣶⣤⣀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣤⣶⣿⣿⣿⣿⣿⣿⣿⣿⣿⣶⣄⠀⠀⠙⢿⣿⣿⣿⣿⣿⣷⣤⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⠀⣠⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣟⡿⢷⡀⠀⠈⢻⣿⣿⣿⣿⣿⣿⣧⢀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⡠⣫⡿⣿⣿⢟⣾⣿⡟⣿⣿⣿⣿⣿⠎⠟⠀⠀⢴⡻⠄⠀⠀⢻⣿⠿⢿⣿⠃⠉⢠⣤⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠔⠄⠀⠙⠳⠋⠎⠉⠚⢁⣄⣀⢸⠉⠁⠀⡈⢶⣾⣿⣷⣾⡀⠀⠀⢶⣦⡴⣦⣶⣂⣦⢿⡄⠀⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⣸⣵⣦⣧⣶⣾⣿⣿⣿⣿⣿⣻⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣇⢀⣀⡸⣿⣿⣻⣿⣷⢾⣿⣿⡀⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⢠⣷⣿⣾⣿⣿⣿⣿⣿⣿⣿⣿⣏⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣌⣿⣰⢿⣿⣷⢿⣿⣿⣿⣿⣇⠀⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⢿⣿⣿⣿⣿⡜⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡟⣿⣿⣿⣿⣿⡃⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠘⣿⣿⣿⣿⣿⣿⠿⠇⠙⠛⡻⢟⣋⠉⠛⠛⠛⠛⠛⠿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣹⣿⣿⣿⣿⣷⠀⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠙⢿⣟⢿⣿⣁⣐⠀⠀⠀⠀⠘⢻⣿⡷⢦⡄⠀⠀⠀⣸⣿⣿⣿⣿⠟⠛⠻⣿⣿⣿⣯⣿⣿⣿⣿⣿⡄⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠉⠃⢹⣏⢻⠇⠀⠀⠀⠀⠨⠽⠥⠊⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣹⣿⣿⣿⣿⣇⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⠀⢸⣏⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⢿⣿⣿⣿⣿⠀⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⠀⣼⠇⠠⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡾⣿⣿⣿⣿⡇⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⠀⣿⣇⠸⣄⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣏⣿⣿⣿⣿⣿⠀⠀⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⢰⣿⣿⡆⠫⠀⠈⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⢹⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⢻⣿⡇⠀⠀⠀⠀","⠀⠀⡠⠀⠀⠀⠀⣸⣿⣿⣿⡄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣼⣿⣿⣿⠃⢘⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠈⣿⣿⠀⠀⠀⠀","⠀⢠⣧⠀⠀⠀⢀⣿⣿⣿⣿⣿⣦⣀⣀⣀⣀⣠⣄⡀⠀⠀⣿⣿⣿⣯⡶⠟⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠁⢹⣿⡇⢠⠀⠀","⠀⠈⣿⣶⣤⣤⣾⣿⡿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣄⠀⣿⣿⣿⣏⠀⣠⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⢀⣿⣿⡇⠀⣧⠀","⠀⠘⣌⡻⠿⠿⠟⢋⣼⣿⡿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡾⠛⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣣⣾⣿⣿⡇⢰⣿⠀","⠀⠀⠘⠻⣷⣶⣾⣿⣿⡿⢳⣿⣿⣿⣿⣿⣿⣿⣿⠛⢋⡠⢆⠈⠻⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⢠⣿⠇⠀","⠀⠀⠀⠀⠀⠈⣯⣉⣁⣴⣿⡿⣿⣿⣿⣿⣿⣿⣿⣧⡀⢋⠝⠃⣀⣴⠟⠻⢛⣭⡿⠚⠋⠉⠁⠒⠫⣙⠻⣿⣿⣿⡟⣱⣿⠋⠀⠀","⠀⠀⠀⠀⠀⠀⠈⠛⠛⠛⠋⣰⣿⣿⣿⣿⣿⣿⣿⣿⣷⣤⡶⠟⠉⠀⢀⣴⠟⠁⠀⠀⠀⠀⠀⠀⠀⠈⠳⣜⢿⣿⠿⠋⠁⠀⠀⠀","⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣰⣿⣿⣿⣿⣿⠿⣿⢯⡾⠋⠀⠀⢀⡔⢀⡾⠃⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⠺⠅⠀⠀⠀⠀⠀⠀"]}

package/assets/plugins/eikon/__init__.py

@@ -1,17 +1,40 @@
-"""Eikon install plugin."""
+"""Eikon lifecycle plugin."""
 
 from __future__ import annotations
 
-from .schemas import EIKON_INSTALL_SCHEMA
-from .tools import _handle_eikon_install, check_herm_available
+from .schemas import (
+    EIKON_INSTALL_SCHEMA,
+    EIKON_LIST_SCHEMA,
+    EIKON_REMOVE_SCHEMA,
+    EIKON_SEARCH_SCHEMA,
+    EIKON_UPDATE_SCHEMA,
+    EIKON_USE_SCHEMA,
+)
+from .tools import (
+    _handle_eikon_install,
+    _handle_eikon_list,
+    _handle_eikon_remove,
+    _handle_eikon_search,
+    _handle_eikon_update,
+    _handle_eikon_use,
+    check_herm_available,
+)
 
 
 def register(ctx) -> None:
-    ctx.register_tool(
-        name="eikon_install",
-        toolset="eikon",
-        schema=EIKON_INSTALL_SCHEMA,
-        handler=_handle_eikon_install,
-        check_fn=check_herm_available,
-        emoji="⬡",
-    )
+    for name, schema, handler in [
+        ("eikon_install", EIKON_INSTALL_SCHEMA, _handle_eikon_install),
+        ("eikon_search", EIKON_SEARCH_SCHEMA, _handle_eikon_search),
+        ("eikon_list", EIKON_LIST_SCHEMA, _handle_eikon_list),
+        ("eikon_use", EIKON_USE_SCHEMA, _handle_eikon_use),
+        ("eikon_update", EIKON_UPDATE_SCHEMA, _handle_eikon_update),
+        ("eikon_remove", EIKON_REMOVE_SCHEMA, _handle_eikon_remove),
+    ]:
+        ctx.register_tool(
+            name=name,
+            toolset="eikon",
+            schema=schema,
+            handler=handler,
+            check_fn=check_herm_available,
+            emoji="⬡",
+        )

package/assets/plugins/eikon/plugin.yaml

@@ -1,7 +1,12 @@
 name: eikon
 version: 1.0.0
-description: "Herm eikon installer tool. Lets Hermes chat install terminal avatars through the existing `herm eikon install` CLI path."
+description: "Herm eikon lifecycle tools. Lets Hermes chat search, install, activate, update, and remove terminal avatars through the existing `herm eikon` CLI path."
 author: Liftaris
 kind: standalone
 provides_tools:
   - eikon_install
+  - eikon_search
+  - eikon_list
+  - eikon_use
+  - eikon_update
+  - eikon_remove

package/assets/plugins/eikon/schemas.py

@@ -7,7 +7,7 @@ EIKON_INSTALL_SCHEMA = {
     "description": (
         "Install a Herm eikon/avatar from the public catalog, a manifest URL, "
         "a git repository, or a local directory. Uses `herm eikon install`; "
-        "no separate eikon executable is required."
+        "set_active activates the installed avatar with `herm eikon use`."
     ),
     "parameters": {
         "type": "object",
@@ -32,10 +32,78 @@ EIKON_INSTALL_SCHEMA = {
             },
             "set_active": {
                 "type": "boolean",
-                "description": "Set the installed eikon as the active Herm avatar. Default true.",
+                "description": "Activate the installed eikon after install. Default true.",
                 "default": True,
             },
+            "active_ok": {
+                "type": "boolean",
+                "description": "Allow replacing the active eikon's backing package when installing over it.",
+                "default": False,
+            },
         },
         "required": ["source"],
     },
 }
+
+EIKON_SEARCH_SCHEMA = {
+    "name": "eikon_search",
+    "description": "Search the Herm eikon marketplace/catalog via `herm eikon search --json`.",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "query": {"type": "string", "description": "Optional search query."},
+        },
+    },
+}
+
+EIKON_LIST_SCHEMA = {
+    "name": "eikon_list",
+    "description": "List installed Herm eikons via `herm eikon list --json`.",
+    "parameters": {"type": "object", "properties": {}},
+}
+
+EIKON_USE_SCHEMA = {
+    "name": "eikon_use",
+    "description": "Set an installed or bundled Herm eikon as active via `herm eikon use --json`.",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "name": {"type": "string", "description": "Installed or bundled eikon name."},
+        },
+        "required": ["name"],
+    },
+}
+
+EIKON_UPDATE_SCHEMA = {
+    "name": "eikon_update",
+    "description": "Update an installed Herm eikon from its recorded source via `herm eikon update --json`.",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "name": {"type": "string", "description": "Installed eikon name."},
+            "active_ok": {
+                "type": "boolean",
+                "description": "Allow updating the active avatar's backing package.",
+                "default": False,
+            },
+        },
+        "required": ["name"],
+    },
+}
+
+EIKON_REMOVE_SCHEMA = {
+    "name": "eikon_remove",
+    "description": "Remove an installed Herm eikon via `herm eikon remove --json`.",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "name": {"type": "string", "description": "Installed eikon name."},
+            "active_ok": {
+                "type": "boolean",
+                "description": "Allow clearing the active avatar if this eikon is active.",
+                "default": False,
+            },
+        },
+        "required": ["name"],
+    },
+}

package/assets/plugins/eikon/tools.py

@@ -30,40 +30,96 @@ def check_herm_available() -> bool:
     return shutil.which(binary) is not None
 
 
-def _handle_eikon_install(args: dict[str, Any], **_: Any) -> str:
-    source = str(args.get("source") or "").strip()
-    if not source:
-        return _json({"ok": False, "error": "source is required"})
-
+def _run(parts: list[str], label: str, timeout: int = 120) -> dict[str, Any]:
     binary = _herm_bin()
     if not binary:
-        return _json({"ok": False, "error": "herm executable not found on PATH"})
-
-    cmd = [binary, "eikon", "install", source, "--json"]
-    name = str(args.get("name") or "").strip()
-    if name:
-        cmd.extend(["--name", name])
-    if args.get("media") is False or args.get("no_source") is True:
-        cmd.append("--no-source")
-    if args.get("set_active") is False:
-        cmd.append("--no-use")
+        return {"ok": False, "error": "herm executable not found on PATH"}
 
     try:
-        proc = subprocess.run(cmd, capture_output=True, text=True, timeout=120, check=False)
+        proc = subprocess.run([binary, *parts], capture_output=True, text=True, timeout=timeout, check=False)
     except FileNotFoundError:
-        return _json({"ok": False, "error": f"herm executable not found: {binary}"})
+        return {"ok": False, "error": f"herm executable not found: {binary}"}
     except subprocess.TimeoutExpired:
-        return _json({"ok": False, "error": "herm eikon install timed out"})
+        return {"ok": False, "error": f"herm eikon {label} timed out"}
 
     stdout = (proc.stdout or "").strip()
     stderr = (proc.stderr or "").strip()
     if proc.returncode != 0:
         detail = stderr or stdout or f"exit {proc.returncode}"
-        return _json({"ok": False, "error": f"herm eikon install failed: {detail}"})
+        return {"ok": False, "error": f"herm eikon {label} failed: {detail}"}
 
     line = next((ln for ln in reversed(stdout.splitlines()) if ln.strip()), "")
     try:
         payload = json.loads(line)
     except json.JSONDecodeError:
-        return _json({"ok": False, "error": "herm eikon install returned non-JSON output", "output": stdout})
-    return _json(payload)
+        return {"ok": False, "error": f"herm eikon {label} returned non-JSON output", "output": stdout}
+    if isinstance(payload, dict):
+        return payload
+    return {"ok": True, "result": payload}
+
+
+def _name(args: dict[str, Any]) -> str:
+    return str(args.get("name") or "").strip()
+
+
+def _handle_eikon_install(args: dict[str, Any], **_: Any) -> str:
+    source = str(args.get("source") or "").strip()
+    if not source:
+        return _json({"ok": False, "error": "source is required"})
+
+    cmd = ["eikon", "install", source, "--json"]
+    name = _name(args)
+    if name:
+        cmd.extend(["--name", name])
+    if args.get("media") is False or args.get("no_source") is True:
+        cmd.append("--no-source")
+    if args.get("active_ok") is True:
+        cmd.append("--active-ok")
+
+    payload = _run(cmd, "install")
+    if not payload.get("ok") or args.get("set_active") is False:
+        return _json(payload)
+
+    active = _run(["eikon", "use", str(payload.get("name") or source), "--json"], "use")
+    if not active.get("ok"):
+        return _json({"ok": False, "installed": payload, "error": f"installed but activation failed: {active.get('error', 'unknown error')}"})
+    return _json({**payload, "active": active.get("active")})
+
+
+def _handle_eikon_search(args: dict[str, Any], **_: Any) -> str:
+    query = str(args.get("query") or "").strip()
+    cmd = ["eikon", "search"]
+    if query:
+        cmd.append(query)
+    return _json(_run([*cmd, "--json"], "search"))
+
+
+def _handle_eikon_list(args: dict[str, Any], **_: Any) -> str:
+    return _json(_run(["eikon", "list", "--json"], "list"))
+
+
+def _handle_eikon_use(args: dict[str, Any], **_: Any) -> str:
+    name = _name(args)
+    if not name:
+        return _json({"ok": False, "error": "name is required"})
+    return _json(_run(["eikon", "use", name, "--json"], "use"))
+
+
+def _handle_eikon_update(args: dict[str, Any], **_: Any) -> str:
+    name = _name(args)
+    if not name:
+        return _json({"ok": False, "error": "name is required"})
+    cmd = ["eikon", "update", name, "--json"]
+    if args.get("active_ok") is True:
+        cmd.append("--active-ok")
+    return _json(_run(cmd, "update"))
+
+
+def _handle_eikon_remove(args: dict[str, Any], **_: Any) -> str:
+    name = _name(args)
+    if not name:
+        return _json({"ok": False, "error": "name is required"})
+    cmd = ["eikon", "remove", name, "--json"]
+    if args.get("active_ok") is True:
+        cmd.append("--active-ok")
+    return _json(_run(cmd, "remove"))

package/assets/skills/eikon/SKILL.md

@@ -9,7 +9,7 @@ related_skills: [eikon-create]
 An eikon is a 48×24 monochrome text avatar. It lives on disk as:
 
     ~/.hermes/eikons/<name>/
-      <name>.eikon      packed NDJSON — written by Studio on Ctrl+S
+      <name>.eikon      packed NDJSON — written by Studio on Ctrl+S / Ctrl+U
       studio.json       Studio's workspace state
       source/           base.<ext>, <state>.<ext>
 
@@ -25,7 +25,8 @@ Herm's built-in **Eikon** tab (Gallery / Studio / Marketplace). Tell the user:
 - `input` section → contrast / invert / flip (pixel-domain, shared)
 - `<rasterizer>` section → symbols / fill / dither (glyph-domain)
 - Preview pane → wheel pans, Ctrl+wheel zooms, Shift+wheel pans X
-- **Ctrl+S** bakes all six states and sets it active
+- **Ctrl+S** bakes all six states without changing the active avatar
+- **Ctrl+U** bakes all six states and uses it as the active avatar
 
 ## What makes a good source
 
@@ -40,11 +41,44 @@ everything.
 | "make me an eikon of X" | Load `eikon-create` and follow it. |
 | drops an image path | `cp` it to `~/.hermes/eikons/<name>/source/base.<ext>` → "Eikon tab, pick <name>". |
 | "edit my <name> eikon" | "Eikon tab → `eikon` row → <name>." |
-| "install/shared marketplace eikon" | "Eikon tab → Marketplace", or `/marketplace`. |
+| "install/shared marketplace eikon" | "Eikon tab → Marketplace", or `/marketplace`. Install, then Use when ready. |
+| "install from GitHub" | "Eikon tab → New… → inspect/install", or `herm eikon install github.com/user/repo/eikon-name`. |
 | "too dark / washed out" | "invert toggle, then contrast slider — under `input`." |
 | "off-center / too small" | "Ctrl+wheel to zoom, wheel/drag to pan on the preview." |
 | "make it move" | `eikon-create` §5 (video), or Studio's `source` → Generate video…. |
 
+## Install and manage shared eikons
+
+For catalog eikons, use **Eikon → Marketplace**. Rows show source,
+compatibility, and trust (`Verified`, `Unverified`, or `Mismatch`).
+Marketplace installs fetch built package artifacts and do not clone creator
+repos.
+
+For direct sharing, use `github.com/user/repo/eikon-name` for a multi-eikon
+GitHub catalog repo, `github.com/user/repo` for a single-package repo, or a
+local package directory. Private GitHub repos use normal git authentication.
+
+The local lifecycle is explicit:
+
+```bash
+herm eikon search [query]
+herm eikon inspect <name|github.com/user/repo/eikon-name|dir>
+herm eikon install <name|github.com/user/repo/eikon-name|dir>
+herm eikon use <name>
+herm eikon info <name>
+herm eikon update <name> --active-ok
+herm eikon remove <name> --active-ok
+```
+
+`install` never activates. `use` activates. Updating or removing the active
+eikon requires explicit acknowledgement because it changes or clears the active
+avatar.
+
+Creators share through normal GitHub repositories. Use upstream `eikon pack`,
+`eikon index`, and `eikon manifest` to prepare repo artifacts. `eikon publish`
+is a GitHub PR contribution helper for the configured/default catalog repo, not
+a hosted marketplace account or upload flow.
+
 ## Quick poster
 
 To show a candidate in chat without Studio:

package/assets/skills/eikon-create/SKILL.md

@@ -16,6 +16,8 @@ deliverable is one or more images/videos under
 named so Studio resolves them: `base.*` for the default pose, `<state>.*`
 for per-state overrides (`idle listening thinking speaking working
 error`). Extensions: `png jpg jpeg webp gif bmp mp4 webm mov mkv`.
+Studio bakes with **Ctrl+S** without activation; **Ctrl+U** bakes and uses the
+eikon as the active avatar.
 
 ## What survives rasterization
 
@@ -140,7 +142,8 @@ Adopt as `<state>.mp4` (or `base.mp4` for an animated idle).
 Once source files are in place:
 
 > Open the **Eikon** tab → `eikon` row → **<name>**. Tune zoom /
-> contrast / invert / symbols there, then **Ctrl+S** to bake.
+> contrast / invert / symbols there, then **Ctrl+S** to bake or **Ctrl+U**
+> to bake and use.
 
 Stop there. Studio writes `<name>.eikon` and `studio.json`.