Skip to content
cavi-aiPublic

About

🧩 Cross-host plugin catalog for Claude, Codex, Agy, OpenCode, OpenClaw, Hermes, and AgentSkills.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

Β 

History

13 Commits

Folders and files

Repository files navigation

CAVI plugins for agent hosts

cavi-ai/plugins is CAVI's host-neutral discovery catalog for installable agent extensions. Plugin source stays in each plugin's own repository; this repository publishes one canonical catalog and validated host projections.

Plugins

Plugin Claude Codex Agy OpenCode OpenClaw Hermes AgentSkills
mlx-agent β€” discover, verify, and wire local MLX models βœ“ βœ“ βœ“ βœ“ βœ“ βœ“ βœ“
obsidian-agent β€” portable vault workflows over the official Obsidian CLI βœ“ βœ“ β€” βœ“ β€” β€” βœ“
loop-killer β€” end stop-hook re-prompt loops by clearing the active goal βœ“ β€” β€” β€” β€” β€” β€”

The machine-readable source of truth is catalog.json. Claude and Codex consume native marketplace projections. Agy, OpenCode, OpenClaw, and Hermes use the discovery records under providers/, which link to each source repository's tested installer; those files do not claim a native marketplace protocol. Portable AgentSkills packages remain available from each plugin repository.

Claude Code

Add the marketplace, then install a plugin:

/plugin marketplace add cavi-ai/plugins
/plugin install mlx-agent@cavi-ai
/plugin install obsidian-agent@cavi-ai
/plugin install loop-killer@cavi-ai

Codex

Add the marketplace, then install either plugin:

codex plugin marketplace add cavi-ai/plugins
codex plugin add mlx-agent@cavi-ai
codex plugin add obsidian-agent@cavi-ai

The Codex projection at .agents/plugins/marketplace.json uses Codex's documented marketplace-local source layout. packages/codex/ contains minimal, self-contained projections copied from exact upstream commits. Each package includes provenance and a deterministic tree hash; catalog validation rejects local drift.

These package projections are distribution artifacts, not independent workflow sources. Refresh one only from a reviewed upstream commit, update its provenance.json, and run the full catalog gate. Product development remains in the linked plugin repository.

Agy

Agy discovery metadata is in providers/agy/catalog.json. Each entry records the source repository's native installation command:

git clone https://github.com/cavi-ai/mlx-agent.git
agy plugin install ./mlx-agent/providers/agy

The discovery catalog itself does not install anything. obsidian-agent does not ship an Agy plugin.

OpenCode

OpenCode discovery metadata is in providers/opencode/catalog.json. Both source repositories provide preview-first installers:

git clone https://github.com/cavi-ai/mlx-agent.git
python3 mlx-agent/scripts/mlx-agent install opencode --scope user --dry-run --json

git clone https://github.com/cavi-ai/obsidian-agent.git
node obsidian-agent/scripts/install.mjs --host opencode --scope user --dry-run

Review the destination paths and use the exact preview hash when confirming.

OpenClaw and Hermes

OpenClaw and Hermes discovery metadata is in providers/openclaw/catalog.json and providers/hermes/catalog.json. The mlx-agent installer places its skills in $OPENCLAW_STATE_DIR/skills or $HERMES_HOME/skills:

git clone https://github.com/cavi-ai/mlx-agent.git
python3 mlx-agent/scripts/mlx-agent install openclaw --scope user --dry-run --json
python3 mlx-agent/scripts/mlx-agent install hermes --scope user --dry-run --json

Review the destination paths and use the exact preview hash when confirming. obsidian-agent does not ship an OpenClaw or Hermes adapter.

AgentSkills

Both plugins publish portable skills under their AgentSkills adapter. Follow the selected repository's project- or user-scope installation instructions; the catalog does not copy or fork skill content.

Validate the catalog

Node.js 22 or newer is sufficient:

node --test
node scripts/validate-catalog.mjs

Validation rejects identity drift, unknown hosts, packages for undeclared hosts, duplicate entries, non-plugin products, and projections that disagree with the canonical host list, repository, or package path.

About

🧩 Cross-host plugin catalog for Claude, Codex, Agy, OpenCode, OpenClaw, Hermes, and AgentSkills.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages