beginning-harness

One CLI to organize your agent skills, MCP servers, extensions, defaults, project overlays, downstream tool configs, and diagnostics. The package is beginning-harness. The command is bgng.

Agents are only as reliable as the harness around them. beginning-harness makes that harness explicit, inspectable, reusable, and safe to apply across Claude Code, Codex, and Cursor.

Install
Published package
npm install -g beginning-harness
bgng status
From source
git clone https://github.com/remyjkim/beginning-harness.git
cd beginning-harness && bun install
bun run bgng -- status
Point global install at a checkout
export AGENTS_REPO_ROOT=/path/to/beginning-harness
bgng status
What It Harnesses
  • Skills — instructions that guide agent behavior
  • MCP servers — tool definitions that control capability access
  • Extensions — capability families like Parallel and Beads
  • Defaults — machine-wide baseline for reusable capabilities
  • Project overlays — repository-specific agent behavior
  • Downstream state — generated configs for Claude, Codex, Cursor
  • Diagnostics — drift detection before mutating files
More