Nx Import

This handles the messy reality of consolidating repositories into an Nx monorepo while preserving git history. It covers the two main strategies: importing subdirectories one at a time (recommended for monorepos) versus whole repositories (for single-project repos only). The real value is in the gotchas it documents. Nx import doesn't merge root dependencies, targetDefaults, or namedInputs, so you'll need to manually diff and reconcile configs. It also botches pnpm workspace globs by adding literal directory names instead of glob patterns, breaking cross-package imports until you fix it. Worth having if you're migrating multiple repos into Nx, since the official docs don't cover half of these issues.

skills.sh installs: 2.7K
GitHub stars: 30
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add nrwl/nx-ai-agents-config --skill nx-import --agent claude-code

Installs into .claude/skills of the current project.

Files

Quick Start

nx import brings code from a source repository or folder into the current workspace, preserving commit history.
After nx 22.6.0, nx import responds with .ndjson outputs and follow-up questions. For earlier versions, always run with --no-interactive and specify all flags directly.
Run nx import --help for available options.
Make sure the destination directory is empty before importing. EXAMPLE: target has libs/utils and libs/models; source has libs/ui and libs/data-access — you cannot import libs/ into libs/ directly. Import each source library individually.