Nx Console

The Nx Language Server utilizes json-languageservice to provide enhanced intelligence for Nx workspace configuration files.

Supported Features:

• Code Completion (onCompletion):

  • Provides completion results within project.json and workspace.json files.
  • Lists installed executors when defining new targets for a project.
  • Provides relevant option completion results for a selected executor.
  • Note: Support for nx.json is planned for a future release.

• Hover Support (onHover):

  • Provides descriptions for executor options within project.json and workspace.json files.

Nx Console provides a user interface for Nx command-line tools, making advanced monorepo management easier. It helps you avoid remembering complex CLI flags and paths by providing:

• Visual exploration: Easily browse custom generator collections without using the terminal.
• Autocompletion: Get suggestions for command arguments and flags.
• Input validation: Ensure paths (absolute or relative) and flag names are correct before execution.

Nx Console enhances AI features in editors like VSCode and Cursor by providing workspace architecture context, generators, and up-to-date Nx documentation.

It includes an MCP (Model Context Protocol) server for both VSCode and Cursor. You can also install the MCP server independently using the nx-mcp NPM package.

Nx Console integrates with Nx Cloud to provide:

• An overview of current CI Pipeline Executions.
• Notifications when CI tasks complete or encounter errors.
• Guided onboarding for Nx Cloud directly within the editor.

By default, the Nx MCP server runs in minimal mode. This mode hides workspace analysis tools that might overlap with the native capabilities of an AI agent, reducing context window usage and tool clutter.

Hidden tools in Minimal Mode:

• nx_available_plugins
• nx_workspace_path
• nx_workspace
• nx_project_details
• nx_generators
• nx_generator_schema

To expose all tools, run the server with the --no-minimal flag:

npx nx-mcp@latest --no-minimal

To execute the unit tests for the shared-npm library, use the Nx CLI with the test command. The tests are powered by Jest.

nx test shared-npm

To execute the unit tests for the language-server-capabilities-hover library, use the Nx CLI. The tests are executed via Jest.

nx test language-server-capabilities-hover

Execute linting for the shared-types library using ESLint via the Nx CLI.

nx lint shared-types

To build the language-server-capabilities-definition library, use the Nx CLI.

nx build language-server-capabilities-definition

The Nx MCP server allows LLMs to access your monorepo's structure, project relationships, tasks, and documentation. You can run it via npx or integrate it into your AI tools using the following methods:

Via npx (Standard Configuration)

Add this to your MCP client configuration (e.g., mcp.json for Claude Desktop):

{
  "servers": {
    "nx-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["nx-mcp@latest"]
    }
  }
}

Tool-Specific Commands

• Claude Code: claude mcp add nx-mcp npx nx-mcp@latest
• VSCode: code --add-mcp '{"name":"nx-mcp","command":"npx","args":["nx-mcp"]}'
• Warp: Use the /add-mcp slash command or add it via Settings -> AI -> Manage MCP Servers.

Via Nx Console Extension

If using Cursor, you can install the Nx Console extension, which automatically manages the MCP server for you.

You can configure and execute Nx commands without leaving the Command Palette.

1. Open the Command Palette using ⇧⌘P (macOS) or Ctrl+Shift+P (Windows/Linux).
2. Select a specific command, for example, nx: test.
3. Choose the target project.
4. Select from the listed options to modify the executor command parameters.
5. Once configured, select the Execute command at the top of the list to run the task.