setup-monorepo — Claude Code command: what it does, how to install
Configures a monorepo workspace structure with build orchestration. Handy when organizing multiple packages under one repository.
npx claude-code-templates@latest --command setup/setup-monorepoWhat setup-monorepo does
The command inspects your existing directory layout using Bash. It searches for package.json files, scans folder depth, and checks for configs like turbo.json, nx.json, lerna.json, or rush.json. To run these checks, the agent requires Read, Write, Edit, and Bash tool permissions.
Based on the passed flag, it sets up Nx, Turborepo, Lerna, Rush, or Yarn Workspaces. The setup configures workspace dependencies, task caching, and affected package detection for CI/CD pipelines.
Without terminal access, the agent cannot inspect the folder tree to determine project count.
What it helps with
- Organize independent packages into Nx or Turborepo
- Set up task caching and parallel builds
- Configure affected package detection for CI/CD
- Resolve shared workspace dependencies across apps
Example prompts for the agent
- /setup-monorepo --turborepo
- /setup-monorepo --nx
- /setup-monorepo --yarn-workspaces
How to install setup-monorepo
1claude-code-templates
npx claude-code-templates@latest --command setup/setup-monorepo2Manually: put the files in place
.claude/commands/setup-monorepo.mdCall it with /setup-monorepo. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/setup-monorepo.mdCall it with /prompts:setup-monorepo. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/setup-monorepo.prompt.mdManually: put the files in place
.gemini/commands/setup-monorepo.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about setup-monorepo
How to install setup-monorepo in Claude Code?
Run npx claude-code-templates@latest --command setup/setup-monorepo in your project terminal. Alternatively, save the markdown file directly to .claude/commands/setup-monorepo.md.
Which monorepo tools does setup-monorepo configure?
You can pass arguments for Nx, Lerna, Rush, Turborepo, or Yarn Workspaces using flags like --turborepo or --nx.
What permissions does this command require?
The command relies on Read, Write, Edit, and Bash tools to scan directories and edit project configuration files.
Source text
setup-monorepo.md · MIT
--- allowed-tools: Read, Write, Edit, Bash argument-hint: "[monorepo-tool] | --nx | --lerna | --rush | --turborepo | --yarn-workspaces" description: Configure monorepo project structure with comprehensive workspace management and build orchestration --- # Setup Monorepo Configure comprehensive monorepo structure with advanced workspace management: **$ARGUMENTS** ## Current Project State - Repository structure: !`find . -maxdepth 2 -type d | head -10` - Package manager: @package.json or existing workspace configuration - Existing monorepo: @nx.json or @lerna.json or @rush.json or @turbo.json - Project count: !`find . -name "package.json" -not -path "./node_modules/*" | wc -l` ## Task Implement production-ready monorepo with advanced workspace management and build orchestration: **Monorepo Tool**: Use $ARGUMENTS to configure Nx, Lerna, Rush, Turborepo, or Yarn Workspaces **Monorepo Architecture**: 1. **Workspace Structure** - Directory organization, package architecture, shared libraries, application separation 2. **Dependency Management** - Workspace dependencies, version management, package hoisting, conflict resolution 3. **Build Orchestration** - Task dependencies, parallel builds, incremental compilation, affected package detection 4. **Development Workflow** - Hot reloading, debugging, testing strategies, development server coordination 5. **CI/CD Integration** - Build pipelines, affected project detection, deployment orchestration, artifact management 6. **Tooling Configuration** - Shared configurations, code quality tools, testing frameworks, documentation **Advanced Features**: Task caching, distributed execution, performance optimization, plugin ecosystem integration. **Team Productivity**: Developer experience optimization, onboarding automation, maintenance procedures. **Output**: Complete monorepo setup with optimized build system, comprehensive tooling, and team productivity enhancements.
© davila7 · MIT · davila7/claude-code-templates
