NX Conductor - Distributed AI Development Orchestration

🤖 The first NX-native distributed AI development orchestration system 🚀

This workspace contains @nx/claude-sessions, a revolutionary NX plugin that enables library-scoped, concurrency-managed Claude Code sessions with intelligent knowledge persistence and cross-session coordination.

🚀 Quick Start

1. Initialize the Claude Sessions Plugin

npx nx g @nx/claude-sessions:init

2. Start a Library Session

npx nx start-claude-session <library-name> --task="Your task description"

3. Explore the Plugin

See the complete documentation: libs/nx-claude-sessions/README.md

📁 Project Structure

nx-conductor/
├── libs/
│   └── nx-claude-sessions/           # The main plugin
│       ├── src/
│       │   ├── generators/
│       │   │   └── init/             # Workspace initialization
│       │   ├── executors/
│       │   │   └── start-session/    # Session management
│       │   ├── utils/
│       │   │   ├── session-pool.ts   # Concurrency management
│       │   │   └── context-loader.ts # Library context loading
│       │   └── types/                # TypeScript definitions
│       ├── generators.json           # Plugin generators registry
│       ├── executors.json            # Plugin executors registry
│       └── README.md                 # Complete plugin documentation
├── conductor-e2e/                   # End-to-end tests
├── CLAUDE.md                        # Project vision & instructions
└── package.json                     # Workspace dependencies

Run tasks

To run tasks with Nx use:

npx nx <target> <project-name>

For example:

npx nx build myproject

These targets are either inferred automatically or defined in the project.json or package.json files.

More about running tasks in the docs »

Add new projects

While you could add new projects to your workspace manually, you might want to leverage Nx plugins and their code generation feature.

To install a new plugin you can use the nx add command. Here's an example of adding the React plugin:

npx nx add @nx/react

Use the plugin's generator to create new projects. For example, to create a new React app or library:

# Generate an app
npx nx g @nx/react:app demo

# Generate a library
npx nx g @nx/react:lib some-lib

You can use npx nx list to get a list of installed plugins. Then, run npx nx list <plugin-name> to learn about more specific capabilities of a particular plugin. Alternatively, install Nx Console to browse plugins and generators in your IDE.

Learn more about Nx plugins » | Browse the plugin registry »

Set up CI!

Step 1

To connect to Nx Cloud, run the following command:

npx nx connect

Connecting to Nx Cloud ensures a fast and scalable CI pipeline. It includes features such as:

Step 2

Use the following command to configure a CI workflow for your workspace:

npx nx g ci-workflow

Learn more about Nx on CI

Install Nx Console

Nx Console is an editor extension that enriches your developer experience. It lets you run tasks, generate code, and improves code autocompletion in your IDE. It is available for VSCode and IntelliJ.

Install Nx Console »

Useful links

Learn more:

And join the Nx community:

nx-claude-sessions-intelligence

Quick Install