name: icebreakers-monorepo-cli description: Use when working with repoctl or @icebreakers/monorepo in this pnpm/turbo monorepo. Covers CLI tasks like workspace upgrade/ws up, init, clean, mirror, skills sync, creating new template packages (tsdown/vitepress/etc), generating agentic prompt templates (repoctl ai prompt create / ai p new), and editing repoctl.config.ts or monorepo.config.ts defaults.
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
- Confirm the workspace root (look for
pnpm-workspace.yamlandpackage.json). - Check
repoctl.config.tsfirst, thenmonorepo.config.tsfor command defaults or overrides. - Select the task below and follow the linked reference.
Tasks
Create a template package
- Prefer
repoctl new [name]for the guided flow and usereferences/templates.mdfor intent-to-template mapping. - Use
repoctl package create [path](aliaspkg 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, chooselibrary, then choosetsdown. - For non-interactive defaults, set
commands.create.defaultTemplateinrepoctl.config.tsormonorepo.config.ts.
Upgrade or sync monorepo assets
- Prefer
repoctl upgrade; userepoctl 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 fromreferences/commands.md.
Maintenance tasks
- Use
repoctl init,check,clean,mirror, orskills syncfromreferences/commands.md. - Confirm destructive actions (clean) and note repo-wide effects.
References
references/commands.mdfor CLI options and flags.references/templates.mdfor template mapping and placement.references/config.mdforrepoctl.config.ts/monorepo.config.tsdefaults.