plugins/README.md
Snider d01c71d665 docs: refresh marketplace and mcp docs
Summary:\n- updated README and CLAUDE docs for unified marketplace structure\n- documented shared MCP server tools and ethics kernel\n- added updated repo tree covering claude, codex, google, and mcp
2026-02-05 20:48:31 +00:00

2.9 KiB

core-agent

A unified marketplace of Host UK plugins for Claude Code, Codex, and the Gemini CLI. This repo hosts the Claude and Codex suites alongside a shared MCP server and the Axioms of Life ethics kernel.

Marketplace

The public marketplace manifest lives at core-agent/.claude-plugin/marketplace.json and lists all Claude, Codex, and Gemini entries.

Installation

Claude Code:

# Install everything via marketplace
claude plugin add host-uk/core-agent

# Or install specific Claude plugins
claude plugin add host-uk/core-agent/claude/code
claude plugin add host-uk/core-agent/claude/review
claude plugin add host-uk/core-agent/claude/qa

Gemini CLI:

  • Extension lives at core-agent/google/gemini-cli.

Codex:

  • Codex plugins live at core-agent/codex.

Shared MCP Server

A vendor-neutral MCP server lives in core-agent/mcp and is registered in .mcp.json at the repo root.

Run locally:

go run ./mcp/

Tools:

  • marketplace_list — returns the full marketplace registry as structured data
  • marketplace_plugin_info — returns plugin metadata, commands, and skills by name
  • core_cli — runs approved core CLI commands (dev, go, php, build only)
  • ethics_check — returns the ethics modal and axioms kernel

Ethics Kernel

The Axioms of Life ethics kernel is a first-class feature under core-agent/codex/ethics.

  • core-agent/codex/ethics/MODAL.md
  • core-agent/codex/ethics/kernel/axioms.json

Plugin Suites

Claude plugins:

  • claude/api
  • claude/ci
  • claude/code
  • claude/collect
  • claude/coolify
  • claude/core
  • claude/issue
  • claude/perf
  • claude/qa
  • claude/review
  • claude/verify

Codex plugins:

  • codex/awareness
  • codex/ethics
  • codex/guardrails
  • codex/api
  • codex/ci
  • codex/code
  • codex/collect
  • codex/coolify
  • codex/core
  • codex/issue
  • codex/perf
  • codex/qa
  • codex/review
  • codex/verify

Gemini extension:

  • google/gemini-cli

Repository Structure

core-agent/
├── .claude-plugin/           # Unified marketplace manifest
├── .mcp.json                  # MCP server registry
├── claude/                    # Claude plugin suite
├── codex/                     # Codex plugin suite + ethics kernel
├── google/                    # Gemini CLI extension
├── mcp/                       # Shared MCP stdio server
├── CLAUDE.md
└── README.md

Core CLI Integration

These plugins enforce the core CLI for development commands:

Instead of... Use...
go test core go test
go build core build
golangci-lint core go lint
composer test core php test
./vendor/bin/pint core php fmt

License

EUPL-1.2