nx-import

Import repositories into an Nx workspace while preserving commit histories.

1|Updated Jun 3, 2025

Search Tags:#migration #workspace #monorepo #plugins #nx #import #git-history

Ready to run

npx skills add https://github.com/jaysoo/dot-ai-config --skill nx-import-jaysoo

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: nx-import
Source: https://github.com/jaysoo/dot-ai-config/tree/main/dot_gemini/commands/nx-import
Command: npx skills add https://github.com/jaysoo/dot-ai-config --skill nx-import-jaysoo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Import, merge, or consolidate repositories into a single Nx workspace using nx import, enabling adoption of Nx across multiple repos and consolidation of code and history.

Core Features & Use Cases

Subdirectory-at-a-time imports to preserve organization and history
Whole-repo imports with merged nx.json and tsconfig adjustments
After-import guidance: run nx sync, reset, and fix common config issues for stability
Readiness for plugin-driven target configuration and conflict-resolution

Quick Start

Import a source repository into the destination workspace with nx import, ensuring the destination directory is empty.

Frequently Asked Questions about nx-import

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I merge multiple repositories into an Nx workspace while preserving git history?▼

Use the nx import command to merge repositories into an Nx workspace while preserving git history, allowing you to consolidate code and commits from multiple repos.

Can I import a subdirectory from another repo instead of the whole project into my monorepo?▼

Yes, you can import a subdirectory at a time from another repo into your monorepo. This approach preserves the organization and commit history of the specific folder being moved.

What steps are needed after importing a repo into an Nx workspace?▼

After importing a repo into an Nx workspace, you should run nx sync, reset configurations, and fix common config issues like nx.json and tsconfig adjustments to ensure workspace stability.

Does importing a whole repository into an Nx workspace merge the tsconfig files?▼

Yes, importing a whole repository into an Nx workspace involves merging nx.json and making tsconfig adjustments to properly integrate the new project into the monorepo structure.

How do I handle plugin-driven target configuration when consolidating repos into a monorepo?▼

When consolidating repos into a monorepo, the import process provides readiness for plugin-driven target configuration and offers guidance on conflict resolution and fix orders for common issues.

Why does my Nx workspace config break after moving a project from another git repository?▼

Moving a project from another git repository can break Nx workspace config due to non-root config considerations. You need to run nx sync and fix common config issues to restore stability.