Icebreakers Monorepo Cli

Overview

Map user requests to the correct repoctl CLI command, templates, and configuration defaults. Prefer repoctl in examples, allow repo as the short alias, and treat rc as a compatibility alias rather than the primary recommendation.

Quick Workflow

1. Confirm the workspace root (look for pnpm-workspace.yaml and package.json).
2. Check repoctl.config.ts first, then monorepo.config.ts for command defaults or overrides.
3. Select the task below and follow the linked reference.

Tasks

Create a template package

• Prefer repoctl new [name] for the guided flow and use references/templates.md for intent-to-template mapping.
• Use repoctl package create [path] (alias pkg new) when the user explicitly wants direct template selection.
• Example: for "create a tsdown app in apps/my-app", run npx repoctl new my-app, choose library, then choose tsdown.
• For non-interactive defaults, set commands.create.defaultTemplate in repoctl.config.ts or monorepo.config.ts.

Upgrade or sync monorepo assets

• Prefer repoctl upgrade; use repoctl workspace upgrade (ws up) when matching existing scripts or user wording.

Generate agentic prompt templates

• Use repoctl ai prompt create (ai p new) and options from references/commands.md.

Maintenance tasks

• Use repoctl init, check, clean, mirror, or skills sync from references/commands.md.
• Confirm destructive actions (clean) and note repo-wide effects.

References

• references/commands.md for CLI options and flags.
• references/templates.md for template mapping and placement.
• references/config.md for repoctl.config.ts / monorepo.config.ts defaults.