@gmickel/gno 2.3.0 → 2.3.1

package/README.md

@@ -117,7 +117,7 @@ gno daemon --detach  # headless indexing + resident MCP gateway
 
 <!-- public-truth:current-version -->
 
-> Current source version: **v2.3.0**. See [CHANGELOG.md](./CHANGELOG.md).
+> Current source version: **v2.3.1**. See [CHANGELOG.md](./CHANGELOG.md).
 
 <!-- /public-truth -->
 
@@ -288,6 +288,9 @@ gno query "ECONNREFUSED 127.0.0.1:5432" --thorough
 
 ```bash
 gno setup ~/notes --name notes   # Build BM25 and prove an exact local result
+gno skill install --target claude --scope user # Choose your agent
+gno agents install --target claude # Teach retrieval and writing discipline
+gno agents verify --target claude
 gno daemon --detach              # Keep index fresh in the background (macOS/Linux)
 gno query "auth best practices"  # Hybrid search
 gno ask "summarize the API" --answer  # AI answer with citations
@@ -365,6 +368,30 @@ See also: [docs/DAEMON.md](./docs/DAEMON.md)
 
 ### Connect to AI Agents
 
+For a second brain or LLM wiki, install both a connector and the retrieval
+protocol. The skill teaches GNO commands and workflows; the instruction block
+teaches the harness when to retrieve, how to choose an efficient search path,
+and how to cite and maintain knowledge. A connector alone does not establish
+that discipline.
+
+```bash
+gno skill install --target claude --scope user
+gno agents install --target claude
+gno agents verify --target claude
+```
+
+Choose your harness target (`claude`, `codex`, `opencode`, `openclaw`, or
+`hermes`). For MCP clients, install the MCP connector instead of the skill,
+then add the protocol where the harness supports it. `gno agents install`
+without a target covers detected supported harnesses; see the
+[agent instructions guide](docs/AGENT-INSTRUCTIONS.md) for the target matrix and
+manual guidance. It preserves text outside its managed block.
+
+Start a fresh agent session and ask a question answered by an indexed document.
+Check that the agent retrieves it and cites the source. `gno agents verify`
+checks the installed block, not model behavior. CLI and Web UI users can skip
+agent setup.
+
 #### MCP Server (Claude Desktop, Cursor, Zed, etc.)
 
 One command to add GNO to your AI assistant:
@@ -391,7 +418,7 @@ target, add `--force` to preview the replacement without writing it.
 
 Check status: `gno mcp status`
 
-#### Skills (Claude Code, Codex, OpenCode, OpenClaw)
+#### Skills (Claude Code, Codex, OpenCode, OpenClaw, Hermes)
 
 Skills integrate via CLI with no MCP overhead and include second-brain recipe playbooks:
 
@@ -400,6 +427,7 @@ gno skill install --scope user        # User-wide
 gno skill install --target codex      # Codex
 gno skill install --target opencode   # OpenCode
 gno skill install --target openclaw   # OpenClaw
+gno skill install --target hermes     # Hermes
 gno skill install --target all        # All targets
 ```
 
@@ -627,10 +655,12 @@ Give your local LLM agents a long-term memory. GNO integrates as a Claude Code s
 
 ### Skills
 
-Skills add GNO search to Claude Code, Codex, OpenCode, and OpenClaw without MCP protocol overhead:
+Skills teach Claude Code, Codex, OpenCode, OpenClaw, and Hermes how to use GNO. Pair the skill with the retrieval protocol for second-brain and LLM-wiki work:
 
 ```bash
 gno skill install --scope user
+gno agents install --target claude
+gno agents verify --target claude
 ```
 
 ![GNO Skill in Claude Code](./assets/screenshots/claudecodeskill.jpg)
@@ -818,7 +848,23 @@ On [Omarchy](https://omarchy.org/), [**GNO Recall**](https://github.com/gmickel/
 omarchy plugin add https://github.com/gmickel/omarchy-gno-recall --enable
 ```
 
-Requires gno >= 1.36.0 on `PATH`.
+Then install the plugin's verified runtime and, optionally, the Super+R binding:
+
+```bash
+cd ~/.config/omarchy/plugins/gmickel.gno-recall
+./scripts/install-runtime.sh
+./scripts/install-keybind.sh # Optional; checks for conflicts
+```
+
+[Marketplace listing](https://omarchyplugins.com/plugin.html?id=gmickel.gno-recall)
+· [Setup and runtime compatibility](https://github.com/gmickel/omarchy-gno-recall#install)
+· [Screenshots](https://github.com/gmickel/omarchy-gno-recall#screenshots)
+
+Recall uses its own verified GNO/Bun runtime. A global GNO upgrade does not
+update it; follow the plugin's update instructions and shared-index
+compatibility guidance.
+
+![GNO Recall searching a demo index](https://raw.githubusercontent.com/gmickel/omarchy-gno-recall/main/assets/screenshots/overlay-search.png)
 
 ---
 

package/assets/skill/README.md

@@ -1,10 +1,10 @@
 # GNO — Agent Skill
 
 Local-first semantic search for documents, notes, and knowledge bases,
-packaged as a Claude Code / Codex / OpenCode / OpenClaw skill.
+packaged as a Claude Code / Codex / OpenCode / OpenClaw / Hermes skill.
 
 > **TL;DR** — this folder is a runnable agent skill. Drop it into any
-> Claude Code, Codex, OpenCode, or OpenClaw workspace and the agent can
+> Claude Code, Codex, OpenCode, OpenClaw, or Hermes workspace and the agent can
 > index and search your local files through the `gno` CLI.
 
 ## Prerequisites
@@ -13,14 +13,10 @@ You need the `gno` CLI installed locally. The skill drives it; it does
 not ship the binary itself.
 
 ```bash
-# macOS / Linux
-curl -fsSL https://gno.sh/install | bash
-
-# npm / Bun
-bun add -g @gmickel/gno        # or: npm install -g @gmickel/gno
+bun install -g @gmickel/gno
 ```
 
-Verify: `gno --version` should print `1.0.3` or later.
+Verify the installed release with `gno --version`. Use the bundled skill to match that release.
 
 ## Install the skill
 
@@ -30,8 +26,7 @@ you're starting from.
 ### Option A — install from your local `gno` (recommended if you already have GNO)
 
 If you already installed GNO, it ships this skill in-tree. One command
-drops it into the right place for every supported agent, always in sync
-with your installed GNO version:
+drops it into the right place for every supported agent, matching the GNO version installed when you run it:
 
 ```bash
 gno skill install --target claude       # Claude Code (default)
@@ -59,23 +54,67 @@ gno skill paths                         # resolved installation paths
 gno skill uninstall --target all        # remove from all agents
 ```
 
-This path always gives you the skill that matches your GNO CLI — no
-version drift.
+After upgrading GNO, refresh the installed copy as described below.
+
+### Option B: ClawHub-managed installation
+
+Use the [GNO listing](https://clawhub.ai/gmickel/gno) when your harness manages
+skills through a registry. The GNO executable is still required separately.
+
+```bash
+# OpenClaw workspace: run from its workspace root
+bunx clawhub@0.23.3 install @gmickel/gno
+bunx clawhub@0.23.3 update @gmickel/gno
+
+# Hermes hub installation
+hermes skills install clawhub/gno # May require review; prefer the local installer
+hermes skills check
+hermes skills update gno
+```
+
+GNO releases publish the same source bundle to ClawHub. Choose one installer
+for a given skill directory so registry and local copies do not overwrite one
+another. For Hermes, prefer the local GNO installer if your hub version cannot
+retrieve the full bundle. A bare SKILL.md URL may omit recipes and references.
 
-### Option B — install from ClawHub (recommended if you use OpenClaw)
+## Install the retrieval protocol too
 
-ClawHub is the OpenClaw skill registry. Use this when you manage
-skills centrally across multiple workspaces or when you don't have GNO
-installed yet.
+For second-brain and LLM-wiki work, pair the skill with standing instructions
+for the harness. The skill teaches commands and workflows; the protocol teaches
+when to retrieve, which search path to use, and how to cite and maintain knowledge.
 
 ```bash
-openclaw skills install gno             # installs @gmickel/gno
-openclaw skills update gno              # pull a newer version later
-openclaw skills info gno                # inspect what's installed
+gno agents install          # Detected supported harnesses
+gno agents verify
 ```
 
-You can also browse the skill at
-<https://clawhub.ai/gmickel/gno> and download the folder manually.
+Use `--target claude`, `codex`, `opencode`, `openclaw`, or `hermes` for one
+harness. MCP users should install the protocol too where supported. Text outside
+the managed instruction block stays unchanged. Start a fresh session and verify
+that the agent retrieves and cites a document from your index. The verify command
+checks the block, not model behavior. See [agent instructions](https://gno.sh/docs/agents-install).
+
+## Keep installations current
+
+Local installs copy the skill from your installed GNO release. After upgrading,
+refresh the selected target and protocol:
+
+```bash
+gno skill install --target hermes --scope user --force
+gno agents update --target hermes
+gno agents verify --target hermes
+```
+
+`--force` replaces local skill edits. Preserve your customizations before using
+it. Change the target for another harness. Registry installs use their native
+update command instead; upgrading the GNO executable alone does not refresh them.
+
+For unattended registry updates, schedule only the chosen skill's native update
+command with your OS scheduler, using the same user, workspace, and executable
+paths as the interactive install. Preserve logs and keep safety prompts enabled;
+an update that needs approval must remain pending. Run `gno agents update` after
+upgrading GNO. New skill versions can require a newer executable, so update GNO
+before refreshing the skill. Publishing a release does not modify users' machines.
 
 ## What the skill teaches the agent
 

package/browser-extension/artifacts/gno-browser-clipper-v2.3.1.zip.sha256

@@ -0,0 +1 @@
+674db0a56d6ba5a485f4d6195066a7cd700b3dbbbcbf921b12047548fcdd21e0  gno-browser-clipper-v2.3.1.zip

package/browser-extension/dist/manifest.json

@@ -21,5 +21,5 @@
   "content_security_policy": {
     "extension_pages": "script-src 'self'; object-src 'none'; connect-src http://127.0.0.1:*"
   },
-  "version": "2.3.0"
+  "version": "2.3.1"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmickel/gno",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Local semantic search for your documents. Index Markdown, PDF, and Office files with hybrid BM25 + vector search.",
   "keywords": [
     "embeddings",

package/browser-extension/artifacts/gno-browser-clipper-v2.3.0.zip.sha256

@@ -1 +0,0 @@
-9eea4e537f21515ea5de8e1eaea1710b5af0a1201a8b05db399ef0b6874f5f64  gno-browser-clipper-v2.3.0.zip