CLI Commands

kcp-harness serve

Start the MCP compliance proxy. Reads from stdin, writes to stdout (MCP stdio transport).

kcp-harness serve [--config harness.yaml]

Flag	Default	Description
--config	harness.yaml	Path to harness configuration file

The proxy runs until stdin closes (the agent disconnects). All governance decisions are logged to the audit log.

kcp-harness init

Create a harness.yaml template in the current directory.

kcp-harness init [--config custom-name.yaml]

Refuses to overwrite an existing file.

kcp-harness check

Validate the harness configuration and print the parsed config as JSON.

kcp-harness check [--config harness.yaml]

Exits with code 0 if valid, 1 if invalid.

kcp-harness integrate

Generate agent-specific integration files.

# Generate for a specific agent
kcp-harness integrate <agent> [options]

# List all supported agents
kcp-harness integrate --list

# Preview without writing files
kcp-harness integrate <agent> --dry-run

Options

Flag	Default	Description
--manifest	./knowledge.yaml	Path to knowledge manifest
--config	—	Path to harness config
--command	npx	Custom harness command
--paths	docs/,src/	Comma-separated governed path prefixes
--out	.	Output directory
--dry-run	—	Print files to stdout instead of writing

Supported Agents

claude-code    cursor    copilot    copilot-cli
windsurf       cline     continue   crush
openclaw

kcp-harness --version

Print the version number.

kcp-harness --help

Print usage information.