agent/README.md

# 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)