v0.14.9 - installation types & harness matrix

One source.Every agent.

Install OpenPack packages, skills, plugins, and MCP sources into every agent runtime.

Browse catalogue Install

openpack.json

skillsrulesinstructionscommandssubagentsMCPhookssettingspluginsfragments

OC OpenClaw.openclaw/

CL Claude Code.claude/

CX Codex CLI.codex/

CP GitHub Copilot CLI.github/

HE Hermes.hermes/

+ Your harnessJSONC / JS adapter

Install methods

Start from the CLI, hand the bootstrap markdown to an AI agent, or install the companion skill into the runtime you already use.

CLI Install Agentwheel

Use the package manager on your machine, then initialize a workspace or install directly from the catalogue.

terminal

npm i -g agentwheel
agentwheel init

AI handoff Give install.md to an agent

The markdown tells an agent how to install Agentwheel, verify it, add the companion skill, and use the catalogue.

fetch prompt

curl -fsSL https://raw.githubusercontent.com/NestDevLab/agentwheel/main/install.md

Skill Install the companion skill

Keep Agentwheel usage, safety rules, and catalogue workflows available inside your current agent runtime.

codex local

agentwheel doctor --adapter codex --local
agentwheel install github:NestDevLab/agentwheel --adapter codex --local --skill agentwheel

Next install a resource

Browse the catalogueFind packages, skills, plugins, and MCP servers with copy-ready Agentwheel commands.
Choose scope explicitlyUse --local for project installs or --user for user-level installs.
Preview when neededAdd --dry-run before broad fleet changes or plugin execution.

resource install example

npx agentwheel install github:NestDevLab/agent-must-have#standard --adapter codex,claude

Runtime matrix

Cells show how Agentwheel can surface each OpenPack capability today: files, directories, config-backed entries, runtime-only behavior, planned work, or unsupported targets.

Adapter	Instructions	Rules	Skills	Commands	Subagents	MCP	Hooks	Settings	Plugins	Fragments
OpenClaw	md user	no	dir	runtime	dir + json	json	runtime	json	dir	compose
Claude Code	md	md	dir	md	md	json	json	json	dir	compose
Codex CLI	md	no	dir	no	toml	toml	json	todo	dir	compose
Hermes	md	no	dir user	runtime	yaml knobs	yaml	runtime	yaml	dir	compose
GitHub Copilot CLI	md	md	dir	md	md	json	json	json	dir	compose

Glossary Open the legend for what each badge means in the matrix.

mdMarkdown surfaceAgentwheel writes Markdown files or managed Markdown blocks the runtime reads directly. md userUser-only MarkdownThe runtime has a supported user-level Markdown surface, but no project-local target is claimed. jsonJSON configThe capability is delivered through a JSON file or JSON deep-merge. yamlYAML configThe capability is delivered through YAML config, usually via deep-merge. tomlTOML configThe runtime consumes TOML files or TOML-backed config entries. dirNative directoryAgentwheel places a package directory where the harness discovers it. dir userUser-only directoryThe runtime supports the directory at user scope; local/project discovery is not claimed. dir + jsonDirectory plus JSONThe runtime needs files plus JSON registration, for example OpenClaw subagent workspaces and allowlists. json settingsJSON settings-backedThe capability exists through settings, for example OpenClaw agents.list[]. yaml knobsYAML knobsThe runtime has config knobs, for example Hermes delegation:, not separate artifact files. runtimeRuntime-onlyThe runtime provides behavior, but there is no managed artifact to install. noUnsupported targetAgentwheel does not currently manage this capability for the built-in adapter. todoPlannedThe target is intended but not implemented yet. composeAgentwheel-onlyFragments are composed into other artifacts; they are never installed directly. Artifact-level matrix

Rules and runtime-only features Behavioral guidance for Codex, OpenClaw, and Hermes belongs in instructions, not rules. Config-backed cells mean the capability is managed through the settings/config merger; mixed cells pair config with native files.

How it works

1 Author packageOpenPack repo

2 Resolve graph.agentwheel lock

3 Install nativeHarness surfaces

What stays aligned

artifacts skills/rules/MCP drift-safe plan/apply adapters built-in/custom sources git/local/registry/MCP selective --skill/--select fleet local/SSH

OpenPack manifest

openpack.json

{
  "schemaVersion": 2,
  "name": "your-org/agent-pack",
  "requires": {
    "core": {
      "source": "github:your-org/core-pack",
      "version": "^1.2.0"
    }
  },
  "provides": [
    { "type": "skills", "path": "skills" },
    { "type": "rules", "path": "rules" },
    { "type": "fragments", "path": "fragments" }
  ]
}

Spec openpack.md Graph design CLI README

Package details

Registry entry

index.json

{
  "name": "your-package-name",
  "source": "github:your-org/your-agent-package",
  "type": "package",
  "tags": ["skills", "rules", "instructions"]
}

Asset includes

openpack.json

{
  "type": "skills",
  "path": "skills",
  "assets": [{
    "from": "packages/tmux-bridge/bin",
    "into": "bin",
    "include": ["*.sh"]
  }]
}

Selective install

selective install

$ agentwheel add github:NestDevLab/agent-mesh \
    --skill codex-tmux \
    --adapter codex \
    --installation-type local
$ agentwheel install --skill codex-tmux

MCP registry source

mcp-registry

$ agentwheel install mcp-registry:publisher/server-name \
    --adapter claude \
    --local \
    --dry-run

ClawHub source

clawhub

$ agentwheel install clawhub:@openclaw/whatsapp \
    --adapter openclaw \
    --local \
    --dry-run

Catalogue and registry

Catalogue Registry

publish draft

$ npx agentwheel@latest registry publish https://github.com/owner/repo \
    --description "Reusable skills and rules for coding agents." \
    --tag skills,rules

Advanced usage

Recommended first step: install the Agentwheel companion skill.

The companion skill is optional, but strongly recommended for anyone using Agentwheel regularly. Doctor can also check selected skills, including Syncwheel in Syncwheel-managed workspaces, so the CLI and the agent reinforce each other.

companion skill

$ agentwheel doctor --adapter copilot --user
$ agentwheel install github:NestDevLab/agentwheel --adapter copilot --user --skill agentwheel --dry-run
$ agentwheel doctor --adapter codex --local --skill syncwheel --json

Plan/apply loop

full control

$ npx agentwheel init
$ npx agentwheel add github:your-org/agent-pack --adapter codex --installation-type local
$ npx agentwheel plan
$ npx agentwheel install

Trust and offline

trust

$ agentwheel install --trust "github:your-org/*"
$ agentwheel deps tree
$ agentwheel deps why skills/triage
$ agentwheel install --offline

Fleet config

fleet mode

{
  "agents": {
    "lab-openclaw": { "adapter": "openclaw", "root": "/path/to/openclaw-home", "transport": "local" },
    "remote-codex": {
      "adapter": "codex",
      "root": "/home/agent/project",
      "transport": "ssh",
      "host": "agent-host.example",
      "user": "agent"
    }
  }
}

$ agentwheel install --agent lab-openclaw
$ agentwheel install --all
$ agentwheel update --profile daily --dry-run
$ agentwheel install --profile daily --dry-run
$ agentwheel status --profile daily
$ agentwheel status --all

Docs

install.md AI handoff AGENT.md agent guide llms.txt LLM map README quick start Companion skill recommended setup OpenPack spec manifest format Dependency design graphs and locks DESIGN.md architecture LIFECYCLE.md update model Fleet config agents and SSH GitHub repo source Package registry short names