nx-import

Import repositories into an Nx workspace while preserving commit histories.

1|Updated Jun 3, 2025
One-click install
npx skills add https://github.com/jaysoo/dot-ai-config --skill nx-import-jaysoo
Or copy as Structured Prompt for Agent
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.