omnilimb 0.8.0__tar.gz

omnilimb-0.8.0/LICENSE

@@ -0,0 +1,32 @@
+MIT License
+
+Copyright (c) 2026 seanyang1983
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+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, 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.
+
+-------------------------------------------------------------------------------
+THIRD-PARTY NOTICES
+
+This project is a compatibility bridge. It does NOT bundle or redistribute
+OpenClaw. When the CLI backend is used, it invokes a user-installed `openclaw`
+binary. OpenClaw is distributed under the MIT License, Copyright (c) 2025
+Peter Steinberger / OpenClaw Foundation. "OpenClaw", "ClawHub" and related marks
+belong to their respective owners; this project is not affiliated with or
+endorsed by them. If you choose to redistribute any OpenClaw components, you must
+include their MIT license and attribution.

omnilimb-0.8.0/PKG-INFO

@@ -0,0 +1,244 @@
+Metadata-Version: 2.4
+Name: omnilimb
+Version: 0.8.0
+Summary: Run ClawHub skills, sandbox, Playwright browser & multi-language runtimes as Hermes hands/feet. Structured JSON, zero extra LLM tokens.
+Author-email: seanyang1983 <yase19636404@163.com>
+License: MIT
+Project-URL: Homepage, https://github.com/seanyang1983/omnilimb
+Project-URL: Issues, https://github.com/seanyang1983/omnilimb/issues
+Keywords: hermes,openclaw,clawhub,agent,sandbox,playwright,skills
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyYAML<7,>=6
+Provides-Extra: browser
+Requires-Dist: playwright<2,>=1.44; extra == "browser"
+Provides-Extra: dev
+Requires-Dist: pytest<9,>=8; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <img src="docs/assets/banner.svg" alt="Omnilimb — give your Hermes agent hands & feet" width="100%" />
+</p>
+
+<p align="center">
+  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-36e0c0.svg"></a>
+  <img alt="Python" src="https://img.shields.io/badge/Python-3.10%2B-5b8cff.svg">
+  <img alt="Status" src="https://img.shields.io/badge/edition-free%20community-5b8cff.svg">
+  <img alt="Tokens" src="https://img.shields.io/badge/execution%20path-0%20extra%20LLM%20tokens-36e0c0.svg">
+  <a href="http://www.omnilimb.com"><img alt="Website" src="https://img.shields.io/badge/web-omnilimb.com-9aa4be.svg"></a>
+</p>
+
+<p align="center">
+  <b>English</b> · <a href="README.zh-CN.md">简体中文</a>
+  &nbsp;|&nbsp; 🌐 <a href="http://www.omnilimb.com">omnilimb.com</a>
+</p>
+
+# Omnilimb
+
+**Your Hermes agent is the brain. Omnilimb is the hands and feet.**
+
+Omnilimb is a Hermes plugin that lets an agent *find, install, run and manage*
+[OpenClaw / ClawHub](https://clawhub.ai) community skills — and gives it an
+isolated sandbox, a real Playwright browser, and multi-language runtimes. Every
+capability is exposed as a small, **deterministic structured-JSON tool** the
+agent calls directly, so there are **zero extra LLM tokens on the execution
+path** and no second "agent loop" burning your budget.
+
+> ℹ️ Compatible with OpenClaw &amp; ClawHub; not affiliated with them.
+> "Omnilimb" is an independent product ([omnilimb.com](http://www.omnilimb.com)).
+
+---
+
+## Why Omnilimb
+
+- ⚡ **Zero token overhead.** The execution path never calls a model. The agent
+  decides *once*; Omnilimb does the work deterministically and hands back JSON.
+- 🧰 **A whole toolbox, one small surface.** Eight tools cover skill discovery,
+  install, run, sandbox, browser, and runtimes — no sprawling API to learn.
+- 🛡️ **Safe by default.** Third-party skills run in a Docker sandbox with the
+  network off and automatic rollback. Path-traversal and zip-slip guarded.
+- 🔌 **No lock-in, no phone-home.** Search talks only to the market you pick.
+  Your code, caches and audit log stay on your machine.
+- 🪶 **Runs with or without Node.** The `native` backend is pure Python; the
+  `cli` backend bridges the real `openclaw` / `clawhub` binaries for full parity.
+- 🌐 **Bring your own market.** ClawHub, SkillHub, the official China mirror, a
+  GitHub index — or add your own adapter in a few lines.
+
+<p align="center">
+  <img src="docs/assets/architecture.svg" alt="How Omnilimb fits: Hermes brain → Omnilimb deterministic tools → skills/sandbox/browser/runtime" width="100%" />
+</p>
+
+## The tools
+
+Omnilimb registers these structured-JSON tools the agent can call:
+
+| Tool | What it does |
+|------|--------------|
+| `claw_skill_search` | Search the ClawHub / SkillHub registry |
+| `claw_skill_install` | Install + verify a skill (slug / `git:owner/repo@ref` / local path) |
+| `claw_skill_run` | Deterministically run a skill's script entrypoint |
+| `claw_sandbox_exec` | Run a command in an isolated (Docker) sandbox with rollback |
+| `claw_browser` | Playwright browser automation via a structured action list |
+| `claw_runtime` | Quick snippet in python / node / bash / ruby / go |
+| `claw_skill_list` | List locally installed skills and their provenance |
+| `claw_skill_runs` | Recent run history for installed skills (diagnostics) |
+
+<p align="center">
+  <img src="docs/assets/tools.svg" alt="The eight Omnilimb tools plus the optional dashboard UI" width="100%" />
+</p>
+
+## Quickstart
+
+**As a pip package:**
+
+```bash
+pip install omnilimb               # core
+pip install "omnilimb[browser]"    # + Playwright
+playwright install chromium        # one-time browser download
+hermes plugins enable omnilimb
+```
+
+**As a directory plugin (simplest):**
+
+```bash
+cp -r omnilimb ~/.hermes/plugins/omnilimb
+hermes plugins enable omnilimb
+```
+
+Verify inside a session:
+
+```
+/exo doctor
+```
+
+### Try it locally — no Hermes, no GUI
+
+The plugin is a headless engine; the way to *feel* it is to call its tools and
+read the JSON they return:
+
+```bash
+python scripts/demo.py doctor                  # backend status
+python scripts/demo.py search github 5         # live ClawHub search
+python scripts/demo.py runtime python "print(6*7)"
+python scripts/demo.py sandbox "echo hi"
+python scripts/demo.py menu                    # interactive
+```
+
+## Pick your market
+
+Switch the skills marketplace with `omnilimb.market` (or `OMNILIMB_MARKET`):
+
+| Market | Source | Notes |
+|--------|--------|-------|
+| `clawhub` (default) | clawhub.ai | Official OpenClaw registry, HTTP API v1 |
+| `skillhub` | api.skillhub.cn | China-focused market; server-side search, public zip download |
+| `clawhub-cn` | mirror-cn.clawhub.com | Official China mirror (Volcengine) |
+| `skillsmp` | skillsmp.com | GitHub-hosted skill index |
+
+Add more under `omnilimb.markets` in `~/.hermes/config.yaml` (each is
+`{id, type, base_url, label}` where `type` is one of
+`clawhub | skillhub | clawhub_mirror | skillsmp`). A new adapter class in
+`omnilimb/registries.py` is all it takes to support a new kind of market.
+
+## Pick your backend
+
+Set `omnilimb.backend` in `~/.hermes/config.yaml` (or `OMNILIMB_BACKEND`):
+
+| Mode | Behaviour |
+|------|-----------|
+| `cli` | Bridges to the real `openclaw` / `clawhub` CLIs. Best registry parity. Requires Node + OpenClaw. |
+| `native` | Fully decoupled Python substrate. No Node. Handles sandbox/browser/runtime + `git:`/local skill installs natively. |
+| `auto` (default) | `cli` if the `openclaw` binary is on PATH, else `native`. |
+
+## Dashboard UI (optional)
+
+A dependency-free web UI ships in `dashboard/` for the Hermes dashboard. After
+enabling the plugin and restarting `hermes dashboard`, an **Omnilimb** tab
+appears (after *Skills*) with:
+
+- **Search** — discovery across markets (leaderboards, categories) + a per-skill
+  health check (体检).
+- **Installed** — view/edit `SKILL.md`, run, smoke-test, manage credentials,
+  check readiness, import/export, uninstall.
+- **Favorites** — bookmarked skills.
+- **Audit** — the optional JSONL audit log.
+- **Settings** — backend / market / cache / paths + diagnostics.
+
+The UI follows the active dashboard theme and language automatically.
+
+### See it in action
+
+Live skill search, a one-click **health check (体检)** with a transparent 0–100
+score, and installed-skill management — all in the dashboard tab (click to enlarge):
+
+<table>
+<tr>
+<td width="33%" valign="top"><a href="docs/assets/ui-search.jpg"><img src="docs/assets/ui-search.jpg" alt="Live skill search for PPT across markets"/></a><br/><sub><b>Search</b> — live ClawHub results for “PPT”.</sub></td>
+<td width="33%" valign="top"><a href="docs/assets/ui-healthcheck.jpg"><img src="docs/assets/ui-healthcheck.jpg" alt="Per-skill health check with score breakdown"/></a><br/><sub><b>Health check</b> — transparent 0–100 score.</sub></td>
+<td width="33%" valign="top"><a href="docs/assets/ui-installed.jpg"><img src="docs/assets/ui-installed.jpg" alt="Installed-skills management"/></a><br/><sub><b>Installed</b> — manage everything you’ve added.</sub></td>
+</tr>
+</table>
+
+> 🌐 Project site: **[omnilimb.com](http://www.omnilimb.com)**
+
+## Configure (`~/.hermes/config.yaml`)
+
+```yaml
+omnilimb:
+  backend: auto            # auto | cli | native
+  market: clawhub          # clawhub | skillhub | clawhub-cn | skillsmp
+  sandbox_enabled: true
+  sandbox_image: "python:3.12-slim"
+  sandbox_network: false
+  default_timeout_s: 120
+  max_retries: 2
+  rollback: true
+  registry_base_url: "https://clawhub.ai"
+  browser_headless: true
+  audit_log: false         # write a JSONL audit log of tool calls
+  cache_enabled: true      # local SQLite cache for discovery + search fallback
+  discover_ttl_s: 21600    # discovery leaderboard cache TTL (6h)
+  cache_max_age_s: 604800  # max staleness for offline search fallback (7d)
+```
+
+Settings changed from the dashboard's **Settings** tab are written to a separate
+overrides file (`omnilimb.overrides.json`), never to your hand-authored
+`config.yaml`. Resolution order is `env > overrides > config.yaml`.
+
+## Security
+
+Third-party skills are untrusted code. Prefer `claw_sandbox_exec` with
+`network: false` for anything you don't fully trust. Without Docker, sandbox
+calls run locally and are flagged `"sandboxed": false`. Skill file operations
+and uninstall are path-traversal guarded; archive extraction is zip-slip
+protected. See [`SECURITY.md`](SECURITY.md) to report a vulnerability.
+
+## Development
+
+```bash
+pip install -e ".[dev,browser]"
+pytest -q
+```
+
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) for the architecture rules (the plugin
+never imports or modifies Hermes core, every handler returns JSON and never
+raises) and how to add a market or backend.
+
+## License &amp; editions
+
+> **This is an early test / community edition, licensed under MIT — free to use.
+> A future stable version will adopt an AGPLv3 + commercial dual-license; please
+> plan accordingly.**
+
+This repository contains the **free community edition** only. It is feature-
+complete for finding, installing, running, and managing OpenClaw / ClawHub
+skills locally. Commercial/Pro capabilities (skill → native Hermes conversion,
+AI curation, curated packs, auto-update, assistant console) are **not** part of
+this edition and are planned for a future Pro release under a separate license.
+
+MIT — see [`LICENSE`](LICENSE). Not affiliated with OpenClaw / ClawHub.

omnilimb-0.8.0/README.md

@@ -0,0 +1,221 @@
+<p align="center">
+  <img src="docs/assets/banner.svg" alt="Omnilimb — give your Hermes agent hands & feet" width="100%" />
+</p>
+
+<p align="center">
+  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-36e0c0.svg"></a>
+  <img alt="Python" src="https://img.shields.io/badge/Python-3.10%2B-5b8cff.svg">
+  <img alt="Status" src="https://img.shields.io/badge/edition-free%20community-5b8cff.svg">
+  <img alt="Tokens" src="https://img.shields.io/badge/execution%20path-0%20extra%20LLM%20tokens-36e0c0.svg">
+  <a href="http://www.omnilimb.com"><img alt="Website" src="https://img.shields.io/badge/web-omnilimb.com-9aa4be.svg"></a>
+</p>
+
+<p align="center">
+  <b>English</b> · <a href="README.zh-CN.md">简体中文</a>
+  &nbsp;|&nbsp; 🌐 <a href="http://www.omnilimb.com">omnilimb.com</a>
+</p>
+
+# Omnilimb
+
+**Your Hermes agent is the brain. Omnilimb is the hands and feet.**
+
+Omnilimb is a Hermes plugin that lets an agent *find, install, run and manage*
+[OpenClaw / ClawHub](https://clawhub.ai) community skills — and gives it an
+isolated sandbox, a real Playwright browser, and multi-language runtimes. Every
+capability is exposed as a small, **deterministic structured-JSON tool** the
+agent calls directly, so there are **zero extra LLM tokens on the execution
+path** and no second "agent loop" burning your budget.
+
+> ℹ️ Compatible with OpenClaw &amp; ClawHub; not affiliated with them.
+> "Omnilimb" is an independent product ([omnilimb.com](http://www.omnilimb.com)).
+
+---
+
+## Why Omnilimb
+
+- ⚡ **Zero token overhead.** The execution path never calls a model. The agent
+  decides *once*; Omnilimb does the work deterministically and hands back JSON.
+- 🧰 **A whole toolbox, one small surface.** Eight tools cover skill discovery,
+  install, run, sandbox, browser, and runtimes — no sprawling API to learn.
+- 🛡️ **Safe by default.** Third-party skills run in a Docker sandbox with the
+  network off and automatic rollback. Path-traversal and zip-slip guarded.
+- 🔌 **No lock-in, no phone-home.** Search talks only to the market you pick.
+  Your code, caches and audit log stay on your machine.
+- 🪶 **Runs with or without Node.** The `native` backend is pure Python; the
+  `cli` backend bridges the real `openclaw` / `clawhub` binaries for full parity.
+- 🌐 **Bring your own market.** ClawHub, SkillHub, the official China mirror, a
+  GitHub index — or add your own adapter in a few lines.
+
+<p align="center">
+  <img src="docs/assets/architecture.svg" alt="How Omnilimb fits: Hermes brain → Omnilimb deterministic tools → skills/sandbox/browser/runtime" width="100%" />
+</p>
+
+## The tools
+
+Omnilimb registers these structured-JSON tools the agent can call:
+
+| Tool | What it does |
+|------|--------------|
+| `claw_skill_search` | Search the ClawHub / SkillHub registry |
+| `claw_skill_install` | Install + verify a skill (slug / `git:owner/repo@ref` / local path) |
+| `claw_skill_run` | Deterministically run a skill's script entrypoint |
+| `claw_sandbox_exec` | Run a command in an isolated (Docker) sandbox with rollback |
+| `claw_browser` | Playwright browser automation via a structured action list |
+| `claw_runtime` | Quick snippet in python / node / bash / ruby / go |
+| `claw_skill_list` | List locally installed skills and their provenance |
+| `claw_skill_runs` | Recent run history for installed skills (diagnostics) |
+
+<p align="center">
+  <img src="docs/assets/tools.svg" alt="The eight Omnilimb tools plus the optional dashboard UI" width="100%" />
+</p>
+
+## Quickstart
+
+**As a pip package:**
+
+```bash
+pip install omnilimb               # core
+pip install "omnilimb[browser]"    # + Playwright
+playwright install chromium        # one-time browser download
+hermes plugins enable omnilimb
+```
+
+**As a directory plugin (simplest):**
+
+```bash
+cp -r omnilimb ~/.hermes/plugins/omnilimb
+hermes plugins enable omnilimb
+```
+
+Verify inside a session:
+
+```
+/exo doctor
+```
+
+### Try it locally — no Hermes, no GUI
+
+The plugin is a headless engine; the way to *feel* it is to call its tools and
+read the JSON they return:
+
+```bash
+python scripts/demo.py doctor                  # backend status
+python scripts/demo.py search github 5         # live ClawHub search
+python scripts/demo.py runtime python "print(6*7)"
+python scripts/demo.py sandbox "echo hi"
+python scripts/demo.py menu                    # interactive
+```
+
+## Pick your market
+
+Switch the skills marketplace with `omnilimb.market` (or `OMNILIMB_MARKET`):
+
+| Market | Source | Notes |
+|--------|--------|-------|
+| `clawhub` (default) | clawhub.ai | Official OpenClaw registry, HTTP API v1 |
+| `skillhub` | api.skillhub.cn | China-focused market; server-side search, public zip download |
+| `clawhub-cn` | mirror-cn.clawhub.com | Official China mirror (Volcengine) |
+| `skillsmp` | skillsmp.com | GitHub-hosted skill index |
+
+Add more under `omnilimb.markets` in `~/.hermes/config.yaml` (each is
+`{id, type, base_url, label}` where `type` is one of
+`clawhub | skillhub | clawhub_mirror | skillsmp`). A new adapter class in
+`omnilimb/registries.py` is all it takes to support a new kind of market.
+
+## Pick your backend
+
+Set `omnilimb.backend` in `~/.hermes/config.yaml` (or `OMNILIMB_BACKEND`):
+
+| Mode | Behaviour |
+|------|-----------|
+| `cli` | Bridges to the real `openclaw` / `clawhub` CLIs. Best registry parity. Requires Node + OpenClaw. |
+| `native` | Fully decoupled Python substrate. No Node. Handles sandbox/browser/runtime + `git:`/local skill installs natively. |
+| `auto` (default) | `cli` if the `openclaw` binary is on PATH, else `native`. |
+
+## Dashboard UI (optional)
+
+A dependency-free web UI ships in `dashboard/` for the Hermes dashboard. After
+enabling the plugin and restarting `hermes dashboard`, an **Omnilimb** tab
+appears (after *Skills*) with:
+
+- **Search** — discovery across markets (leaderboards, categories) + a per-skill
+  health check (体检).
+- **Installed** — view/edit `SKILL.md`, run, smoke-test, manage credentials,
+  check readiness, import/export, uninstall.
+- **Favorites** — bookmarked skills.
+- **Audit** — the optional JSONL audit log.
+- **Settings** — backend / market / cache / paths + diagnostics.
+
+The UI follows the active dashboard theme and language automatically.
+
+### See it in action
+
+Live skill search, a one-click **health check (体检)** with a transparent 0–100
+score, and installed-skill management — all in the dashboard tab (click to enlarge):
+
+<table>
+<tr>
+<td width="33%" valign="top"><a href="docs/assets/ui-search.jpg"><img src="docs/assets/ui-search.jpg" alt="Live skill search for PPT across markets"/></a><br/><sub><b>Search</b> — live ClawHub results for “PPT”.</sub></td>
+<td width="33%" valign="top"><a href="docs/assets/ui-healthcheck.jpg"><img src="docs/assets/ui-healthcheck.jpg" alt="Per-skill health check with score breakdown"/></a><br/><sub><b>Health check</b> — transparent 0–100 score.</sub></td>
+<td width="33%" valign="top"><a href="docs/assets/ui-installed.jpg"><img src="docs/assets/ui-installed.jpg" alt="Installed-skills management"/></a><br/><sub><b>Installed</b> — manage everything you’ve added.</sub></td>
+</tr>
+</table>
+
+> 🌐 Project site: **[omnilimb.com](http://www.omnilimb.com)**
+
+## Configure (`~/.hermes/config.yaml`)
+
+```yaml
+omnilimb:
+  backend: auto            # auto | cli | native
+  market: clawhub          # clawhub | skillhub | clawhub-cn | skillsmp
+  sandbox_enabled: true
+  sandbox_image: "python:3.12-slim"
+  sandbox_network: false
+  default_timeout_s: 120
+  max_retries: 2
+  rollback: true
+  registry_base_url: "https://clawhub.ai"
+  browser_headless: true
+  audit_log: false         # write a JSONL audit log of tool calls
+  cache_enabled: true      # local SQLite cache for discovery + search fallback
+  discover_ttl_s: 21600    # discovery leaderboard cache TTL (6h)
+  cache_max_age_s: 604800  # max staleness for offline search fallback (7d)
+```
+
+Settings changed from the dashboard's **Settings** tab are written to a separate
+overrides file (`omnilimb.overrides.json`), never to your hand-authored
+`config.yaml`. Resolution order is `env > overrides > config.yaml`.
+
+## Security
+
+Third-party skills are untrusted code. Prefer `claw_sandbox_exec` with
+`network: false` for anything you don't fully trust. Without Docker, sandbox
+calls run locally and are flagged `"sandboxed": false`. Skill file operations
+and uninstall are path-traversal guarded; archive extraction is zip-slip
+protected. See [`SECURITY.md`](SECURITY.md) to report a vulnerability.
+
+## Development
+
+```bash
+pip install -e ".[dev,browser]"
+pytest -q
+```
+
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) for the architecture rules (the plugin
+never imports or modifies Hermes core, every handler returns JSON and never
+raises) and how to add a market or backend.
+
+## License &amp; editions
+
+> **This is an early test / community edition, licensed under MIT — free to use.
+> A future stable version will adopt an AGPLv3 + commercial dual-license; please
+> plan accordingly.**
+
+This repository contains the **free community edition** only. It is feature-
+complete for finding, installing, running, and managing OpenClaw / ClawHub
+skills locally. Commercial/Pro capabilities (skill → native Hermes conversion,
+AI curation, curated packs, auto-update, assistant console) are **not** part of
+this edition and are planned for a future Pro release under a separate license.
+
+MIT — see [`LICENSE`](LICENSE). Not affiliated with OpenClaw / ClawHub.

omnilimb-0.8.0/omnilimb/__init__.py

@@ -0,0 +1,114 @@
+"""Omnilimb — Hermes plugin.
+
+Turns OpenClaw / ClawHub's mature execution substrate (skill registry, local
+sandbox, Playwright browser automation, multi-language runtimes, retry/rollback)
+into a set of structured-JSON tools for Hermes.
+
+Design:
+- Hermes is the brain (LLM/conversation/memory/UI).
+- Omnilimb is the hands/feet (deterministic execution). It NEVER calls an
+  LLM itself -> zero extra model tokens on the execution path.
+- Two interchangeable backends, switchable via config:
+    * "cli"    -> shells out to the real `openclaw` / `clawhub` CLIs.
+    * "native" -> a decoupled Python re-implementation (no Node dependency).
+    * "auto"   -> cli if the `openclaw` binary is present, else native.
+
+Every tool handler:
+  - has signature `handler(args: dict, **kwargs) -> str`
+  - ALWAYS returns a JSON string (success and error alike)
+  - NEVER raises
+"""
+
+from __future__ import annotations
+
+import logging
+
+from . import schemas, tools
+from .config import get_settings
+
+logger = logging.getLogger(__name__)
+
+__version__ = "0.8.0"
+
+
+def _cli_available() -> bool:
+    """check_fn used to hide CLI-only behaviour gracefully (never raises)."""
+    try:
+        from .backends.cli_backend import openclaw_binary
+
+        return openclaw_binary() is not None
+    except Exception:  # pragma: no cover - defensive
+        return False
+
+
+def _tools_available() -> bool:
+    """Tools are available whenever a backend can be resolved.
+
+    The CLI backend needs the `openclaw` binary; the native backend always
+    resolves. So tools are available unless the user pinned `backend: cli`
+    without installing the CLI.
+    """
+    try:
+        settings = get_settings()
+        if settings.backend == "cli":
+            return _cli_available()
+        return True
+    except Exception:  # pragma: no cover - defensive
+        return True
+
+
+def register(ctx) -> None:
+    """Entry point called once at startup. Wires schemas -> handlers.
+
+    If this function raises, Hermes disables the plugin but keeps running, so we
+    keep it defensive and side-effect-light.
+    """
+    pairs = (
+        ("claw_skill_search", schemas.CLAW_SKILL_SEARCH, tools.claw_skill_search),
+        ("claw_skill_install", schemas.CLAW_SKILL_INSTALL, tools.claw_skill_install),
+        ("claw_skill_list", schemas.CLAW_SKILL_LIST, tools.claw_skill_list),
+        ("claw_skill_runs", schemas.CLAW_SKILL_RUNS, tools.claw_skill_runs),
+        ("claw_skill_run", schemas.CLAW_SKILL_RUN, tools.claw_skill_run),
+        ("claw_sandbox_exec", schemas.CLAW_SANDBOX_EXEC, tools.claw_sandbox_exec),
+        ("claw_browser", schemas.CLAW_BROWSER, tools.claw_browser),
+        ("claw_runtime", schemas.CLAW_RUNTIME, tools.claw_runtime),
+    )
+
+    for name, schema, handler in pairs:
+        ctx.register_tool(
+            name=name,
+            toolset="omnilimb",
+            schema=schema,
+            handler=handler,
+            check_fn=_tools_available,
+        )
+
+    # Ship an opt-in "how to drive me" skill. Not in the system-prompt index,
+    # so it costs zero standing tokens until the agent explicitly loads it.
+    try:
+        from pathlib import Path
+
+        skill_md = Path(__file__).parent / "skills" / "omnilimb" / "SKILL.md"
+        if skill_md.exists():
+            ctx.register_skill("omnilimb", skill_md)
+    except Exception as exc:  # pragma: no cover - optional
+        logger.debug("omnilimb: skill registration skipped: %s", exc)
+
+    # Diagnostics slash command: /exo status
+    try:
+        ctx.register_command(
+            "exo",
+            handler=tools.slash_claw,
+            description="Omnilimb status / backend / diagnostics",
+            args_hint="[status|backend|doctor]",
+        )
+    except Exception as exc:  # pragma: no cover - optional
+        logger.debug("omnilimb: slash command skipped: %s", exc)
+
+    s = get_settings()
+    logger.info(
+        "omnilimb v%s registered (backend=%s, resolved=%s)",
+        __version__,
+        s.backend,
+        s.resolved_backend(),
+    )