Skip to content
Nx Docs

Nx Console Settings Reference

This page provides a complete reference of all configuration settings available for Nx Console. Each setting shows how to configure it in both VSCode and JetBrains IDEs (IntelliJ IDEA, WebStorm, etc.).

Editor Settings

Section titled “Editor Settings”

VSCode uses JSON files for configuration. Settings can be configured at different scopes:

User Settings (global across all workspaces):

  • Apply to all VSCode projects
  • Location: ~/.config/Code/User/settings.json (Linux/macOS) or %APPDATA%\Code\User\settings.json (Windows)
  • Access via: Cmd+, (macOS) or Ctrl+, (Windows/Linux), then click the "Open Settings (JSON)" icon

Workspace Settings (specific to one workspace):

  • Apply only to the current workspace
  • Location: .vscode/settings.json in your workspace root
  • Recommended for team-shared configurations (commit to version control)
  • Override user settings

Learn more about VSCode settings in the official VSCode documentation.

Common Nx Commands

Section titled “Common Nx Commands”

Configure which Nx commands appear in the sidebar view.

Setting: nxConsole.commonNxCommands

Default: ["run", "run-many", "affected", "affected --graph", "list"]

{
  "nxConsole.commonNxCommands": ["run", "run-many", "affected", "test", "build"]
}

This setting supports both arbitrary commands and UI-based commands that open dedicated interfaces.

Project Viewing Style

Section titled “Project Viewing Style”

Defines how the Projects view displays entries in the sidebar.

Setting: nxConsole.projectViewingStyle

Options: "list" | "tree" | "automatic"

Default: "automatic"

{
  "nxConsole.projectViewingStyle": "tree"
}

Options explained:

  • "list": Shows projects as a flat ordered list
  • "tree": Displays projects in a folder/tree structure
  • "automatic": Adaptively switches between list and tree based on workspace structure

Nx Workspace Path

Section titled “Nx Workspace Path”

Specifies the relative path to the Nx workspace root directory.

Setting: nxConsole.nxWorkspacePath

Default: undefined

{
  "nxConsole.nxWorkspacePath": "packages/workspace"
}

Useful when working in a monorepo where the Nx workspace is nested within a larger repository structure.

Enable CodeLens

Section titled “Enable CodeLens”

Controls the visibility of CodeLens features for Nx-specific files.

Setting: nxConsole.enableCodeLens

Default: true

{
  "nxConsole.enableCodeLens": false
}

CodeLens provides inline actionable commands directly in your editor for files like project.json and workspace configuration files.

Enable Library Imports

Section titled “Enable Library Imports”

Configures the TypeScript language server plugin to include configured libraries.

Setting: nxConsole.enableLibraryImports

Default: true

{
  "nxConsole.enableLibraryImports": true
}

This enables better IntelliSense and autocompletion for library imports in your workspace.

Generator Allowlist

Section titled “Generator Allowlist”

Specifies generator names or wildcard patterns to show in the generator picker.

Setting: nxConsole.generatorAllowlist

Default: [] (all generators shown)

{
  "nxConsole.generatorAllowlist": [
    "@nx/react:*",
    "@nx/next:application",
    "@nrwl/workspace:library"
  ]
}

Use the format @package:generator or @package:* for wildcards. When this list is populated, only matching generators will be shown.

Generator Blocklist

Section titled “Generator Blocklist”

Specifies generator names or wildcard patterns to hide from the generator picker.

Setting: nxConsole.generatorBlocklist

Default: []

{
  "nxConsole.generatorBlocklist": ["@nx/angular:*", "*:stories"]
}

Useful for removing generators that aren't relevant to your workflow.

Enable Dry Run on Change

Section titled “Enable Dry Run on Change”

Enables automatic dry runs when using the Generate command.

Setting: nxConsole.enableTaskExecutionDryRunOnChange

Default: true

{
  "nxConsole.enableTaskExecutionDryRunOnChange": false
}

When enabled, changing generator options triggers a dry run to preview the changes before applying them.

Move Generator Patterns

Section titled “Move Generator Patterns”

Controls which collections' move generators should be used based on project path patterns.

Setting: nxConsole.moveGeneratorPatterns

Default: {}

{
  "nxConsole.moveGeneratorPatterns": {
    "apps/**": "@nx/workspace:move",
    "libs/**": "@custom/generators:move"
  }
}

This is useful when you have multiple generator collections and want to specify which move generator to use for different project types.

Nx Cloud Notifications

Section titled “Nx Cloud Notifications”

Controls which Nx Cloud notifications are displayed.

Setting: nxConsole.nxCloudNotifications

Options: "all" | "errors" | "none"

Default: "all"

{
  "nxConsole.nxCloudNotifications": "errors"
}

Options explained:

  • "all": Show all Nx Cloud notifications
  • "errors": Only show error notifications
  • "none": Disable all Nx Cloud notifications

Show Node Version on Startup

Section titled “Show Node Version on Startup”

Shows a notification with the Node.js version information when the IDE starts.

Setting: nxConsole.showNodeVersionOnStartup

Default: false

{
  "nxConsole.showNodeVersionOnStartup": true
}

Useful for debugging version-related issues, especially when using nvm or similar Node version managers.

MCP Port

Section titled “MCP Port”

Specifies a fixed port for the Nx MCP (Model Context Protocol) server.

Setting: nxConsole.mcpPort

Default: undefined (random port)

{
  "nxConsole.mcpPort": 3333
}

Set to 0 to explicitly use a random available port. If not specified, a random port is used by default.

MCP Tools Filter

Section titled “MCP Tools Filter”

Filters which MCP tools are enabled using glob patterns with negation support.

Setting: nxConsole.mcpToolsFilter

Default: [] (all tools enabled)

{
  "nxConsole.mcpToolsFilter": ["nx_*", "!nx_cloud_*"]
}

Use glob patterns to include or exclude specific MCP tools. Prefix with ! to negate a pattern (exclude matching tools).

Enable Debug Logging

Section titled “Enable Debug Logging”

Activates debug logging in output channels and the Language Server.

Setting: nxConsole.enableDebugLogging

Default: false

{
  "nxConsole.enableDebugLogging": true
}

Useful for troubleshooting Nx Console issues. When enabled, detailed debug information is written to the output channels.

Disable File Watching

Section titled “Disable File Watching”

Disables automatic workspace refresh after file changes in the Language Server.

Setting: nxConsole.disableFileWatching

Default: false

{
  "nxConsole.disableFileWatching": true
}

When enabled, the workspace will not automatically refresh when files change. This can be useful for performance optimization in very large workspaces, but you will need to manually refresh the workspace to see changes.

Common Configuration Scenarios

Section titled “Common Configuration Scenarios”

Team Configuration for Specific Framework

Section titled “Team Configuration for Specific Framework”

If your team works primarily with React and Next.js:

Add to .vscode/settings.json:

{
  "nxConsole.generatorAllowlist": [
    "@nx/react:*",
    "@nx/next:*",
    "@nx/workspace:library"
  ],
  "nxConsole.generatorBlocklist": [
    "*:stories",
    "*:cypress-component-configuration"
  ],
  "nxConsole.projectViewingStyle": "tree",
  "nxConsole.enableTaskExecutionDryRunOnChange": true,
  "nxConsole.nxCloudNotifications": "errors"
}

Nested Workspace Setup

Section titled “Nested Workspace Setup”

For monorepos where Nx is nested within a larger repository:

{
  "nxConsole.nxWorkspacePath": "packages/my-workspace"
}

Minimal Noise Configuration

Section titled “Minimal Noise Configuration”

To reduce notifications and automatic behaviors:

{
  "nxConsole.nxCloudNotifications": "errors",
  "nxConsole.enableTaskExecutionDryRunOnChange": false,
  "nxConsole.enableCodeLens": false
}

See Also

Section titled “See Also”