Skip to main content

Installation

Pick the installation path that matches what you want to do. The published package is right for almost everyone; work from a checkout only if you plan to edit the registry, maintain a fork, or develop the CLI itself.

Requirements​

  • Bun 1.2+ - runtime for the CLI
  • Node.js - for MCP servers that spawn node
  • npm - when installing the published package or adding npm skill bundles
  • Optional: parallel-cli, markitdown, or markdownify-mcp, only when you enable those integrations

Install the published package​

npm install -g darwinian-harness
drwn status

The published package ships with built-in harness defaults. By default, a global drwn uses that packaged harness source.

Work from a checkout​

Use this mode if you want to edit the registry, maintain your own fork, add built-in skills, or develop the CLI:

git clone https://github.com/remyjkim/darwinian-harness.git
cd darwinian-harness
bun install
bun run drwn -- status

You can also point a globally-installed drwn at a local checkout:

export AGENTS_REPO_ROOT=/path/to/darwinian-harness
drwn status

For day-to-day development inside the checkout, link the package:

bun link
drwn --help

Verify the install​

drwn --help
drwn status

You should see the CLI help banner and a status summary listing repo root, ~/.agents path, enabled targets, and current inventory counts.

Next​

Continue to First Run to walk through the standard dry-run to write sequence.