@gentleduck/cli

@gentleduck/cli

CLI for initializing duck-ui config and installing/updating/removing registry components.

Install

npx @gentleduck/cli --help

Commands

npx @gentleduck/cli init [components...]
npx @gentleduck/cli add [components...]
npx @gentleduck/cli update [components...]
npx @gentleduck/cli remove [components...]
npx @gentleduck/cli diff [components...]

Monorepo Workspace Targeting

When duck-ui.config.json has "monorepo": true, the CLI resolves target paths from the config workspace field.

You can override the target workspace per command:

npx @gentleduck/cli add button --workspace apps/web
npx @gentleduck/cli update --all --workspace apps/web
npx @gentleduck/cli diff button --workspace apps/web

For init:

npx @gentleduck/cli init --monorepo --workspace apps/web

The CLI validates the workspace target:

• package.json must exist
• tsconfig.json must exist for component commands

Migration

Legacy duck-ui.config.json files (without workspace) are rejected.

Re-run init to migrate:

npx @gentleduck/cli init

Release Workflow

This repo uses Changesets for versioning and publishing.

• Add a changeset for CLI changes:

bun run changeset

• Update versions/changelogs:

bun run version-packages

• Validate package before publish:

bun run --cwd packages/duck-cli test
bun run --cwd packages/duck-cli build

• Publish (repo-level script):

bun run release