Skip to main content

First Run

The recommended first-run sequence inspects state before mutating it. Every step is non-destructive until the final drwn write.

Inspect before writing​

drwn status
drwn skills list
drwn mcp list
drwn write --dry-run

That gives you:

  • a system overview
  • the current skill inventory
  • the active MCP inventory
  • a planned-change preview

Write the generated state​

If the dry run looks right:

drwn write

drwn write is the primary one-way materialization command. It reads global config, project config, card locks, and local inventory, then writes effective state into downstream tools.

drwn is conservative on write:

  • write is non-destructive by default
  • drwn-owned stale materialization is cleaned up through write records
  • user-owned stale state is reported, not silently removed

Project-local overrides​

If you want overrides for a single project instead of changing your machine-wide config, scaffold a project config first:

cd /path/to/project
drwn init
drwn status
drwn write --dry-run

drwn init creates <project>/.agents/drwn/config.json and switches subsequent drwn write runs into project-local materialization under <project>/.claude, <project>/.codex, and <project>/.cursor.

Agent Workflow Skills​

If you want an agent to operate the CLI with the same inspect, dry-run, approval, and verification discipline, install the Darwinian Harness Skills bundle:

drwn library add skill github:remyjkim/darwinian-harness-skills
drwn add skill bootstrap-project --dry-run --json

Useful first-run skills:

  • bootstrap-project for project setup
  • inspect-harness for read-only state and provenance
  • materialize-harness for targeted drwn write flows

Next​