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.