| 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.yaml and package.json).
- Check
repoctl.config.ts first, then monorepo.config.ts for 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 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.
