d01c71d665
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
126 lines
2.9 KiB
Markdown
126 lines
2.9 KiB
Markdown
# 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:
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
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
|
|
|
|
## Links
|
|
|
|
- [Host UK](https://host.uk.com)
|
|
- [Claude Code Documentation](https://docs.anthropic.com/claude-code)
|
|
- [Issues](https://github.com/host-uk/core-agent/issues)
|