Skip to main content

Init

drwn init creates the per-project config scaffold at <project>/.agents/drwn/config.json. In a TTY it runs guided setup; in non-interactive contexts it writes a minimal config.

Bootstrap a project from an interactive shell:

drwn init

Guided init prompts once for Parallel and once for Beads. Answering yes to either records the corresponding extensions.<name> block in the project config — no global side effects.

For scripts and CI:

drwn init --non-interactive
drwn init --minimal

--non-interactive and --minimal are equivalent: both skip prompts and write the bare { "version": 1 } config.

Force the guided flow even when invoked with flags:

drwn init --guided

Re-run setup on a project that already has a config:

drwn init --force
drwn init --force --guided

Without --force, drwn init refuses to overwrite an existing project config.

Skip pre-registering the default community card catalog:

drwn init --no-default-catalogs

By default, drwn init registers the public Curation Labs community card catalog into ~/.agents/drwn/catalogs.json so that drwn search card <query> works out of the box:

https://github.com/curation-labs/dm-cards-catalog-v1.git

The default catalog URL is configured in the packaged registry at defaults.communityCatalogUrl (currently https://github.com/curation-labs/dm-cards-catalog-v1.git). To swap it for a fork or a private catalog, edit registry/config.json and rerun drwn init. To disable the default registration entirely without using the flag every time, set defaults.communityCatalogUrl to null.

Side effects​

  • Writes <project>/.agents/drwn/config.json.
  • In guided mode, may add extensions.parallel and/or extensions.beads blocks based on prompt answers.
  • Registers the default @community card catalog under ~/.agents/drwn/ unless --no-default-catalogs is passed.
  • Reads <project>/.gitignore if present and warns when it appears to exclude .agents. The file is never mutated.

What you can edit afterward​

The project overlay can:

  • enable or disable MCP servers for this project
  • add project-local MCP server definitions
  • enable extensions such as Parallel, Beads, or MarkItDown
  • include or exclude skills during write
  • enable or disable targets locally

See Per-project configuration and .ai/knowledges/02_per-project-config-guide.md for the full overlay model.