---
schema_version: "1"
id: 12e50cc641b76715ae8e75e3dc5056281b32ce5bae4811473494b91add163c92
title: Running Multiple Local Integration Projects with MuleSoft Vibes
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/anypoint-code-builder/vibes-run-multiple-integration-projects-locally.md
canonical_url: https://docs.mulesoft.com/anypoint-code-builder/vibes-run-multiple-integration-projects-locally
source_site: docs.mulesoft.com
content_type: documentation
content_hash: fbd40620c88b0d5c413e9b6f9ac440d905595d63d14fbb4561303d25a5347e08
description: MuleSoft Documentation Site
latest: true
---
---
product: Anypoint Code Builder
version: master
---

# Running Multiple Local Integration Projects with MuleSoft Vibes

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Run multiple integration projects locally in one runtime to validate service-to-service behavior
before deployment. Use MuleSoft Vibes to create a reusable run configuration automatically, start
related projects together, and test end-to-end behavior. Update and reuse the same configuration as
your local integration scope changes.

When an integration depends on multiple local Mule projects, starting each project manually can slow
down validation and increase setup errors. MuleSoft Vibes can create a run configuration from your
prompt and execute all selected projects together in the same local runtime instance.

When MuleSoft Vibes creates a multi-project configuration, it uses the default runtime arguments
defined in Anypoint Code Builder settings
([Mule > Runtime: Default Arguments](https://docs.mulesoft.com/anypoint-code-builder/ref-mule-settings#setting-mule-args)) to keep the configuration
simple. You can override these defaults by adding `mule.runtime.args` directly to the launch
configuration.

## Before You Begin

- [Work in a multi-root workspace](https://docs.mulesoft.com/anypoint-code-builder/start-workspaces) that contains the related Mule projects.

- [Set up MuleSoft Vibes](https://docs.mulesoft.com/anypoint-code-builder/mulesoft-vibes) and confirm you have required permissions.

- Verify that each project can run locally in your environment.

## Run Related Projects Together Locally

Use MuleSoft Vibes to create and run a reusable local run configuration for the projects that
participate in your flow.

1.  Open MuleSoft Vibes.

2.  Enter a prompt that identifies the projects to run together.

    Example prompts:

    - `Create and run a local configuration for main-project, project-one, and project-two.`

    - `Run all projects in this workspace.`

    - `Run all my projects in debug mode.`

3.  Review the plan if you are working in Plan mode, and then run the task.

4.  Wait for MuleSoft Vibes to create the run configuration and start the selected projects.

5.  Confirm that the projects are running in the same local runtime instance.

## Run Saved Configurations from Anypoint Code Builder

After MuleSoft Vibes creates a multi-project configuration, you can reuse it through standard
execution paths.

1.  Open the **Run and Debug** panel.

2.  Select the saved multi-project configuration from the launch configuration list.

3.  Run it from the launch menu.

    You can also run the same saved configuration from the Command Palette with
    `MuleSoft: Run Multi-Project Configuration`.

## Create and Update Configurations for Debugging

You can create or update multi-project configurations for either run mode or debug mode.

1.  Ask MuleSoft Vibes to run your projects in debug mode when you need to inspect flow execution.

2.  If needed, update an existing configuration to change the execution mode.

    Example prompts:

    - `Run all my projects in debug mode.`

    - `Change my configuration to debug mode.`

## Verify End-to-End Integration Behavior

After MuleSoft Vibes starts the projects, validate the integration behavior from the entry-point
project.

1.  Call an endpoint in your main project.

2.  Confirm that downstream project responses are returned as expected.

3.  Verify that the final response includes the combined or orchestrated output for your flow.

## Update and Reuse a Saved Configuration

When your integration scenario changes, ask MuleSoft Vibes to update the existing configuration
instead of recreating setup steps manually.

1.  In MuleSoft Vibes, request an update to the saved configuration.

    Example prompts:

    - `Update my local run configuration to include only project-one and project-two.`

    - `Rename this local run configuration to project-one-two flow validation.`

    - `Change my configuration to debug mode.`

2.  Run the saved configuration again for the next validation cycle.

3.  Repeat updates as your project set changes.

## Set Explicit Mule and JDK Versions

By default, a multi-project configuration uses the latest compatible Mule runtime and JDK versions
that are available locally for execution. If your validation requires exact versions, edit the
generated launch configuration in your `.code-workspace` file and specify them explicitly.

1.  Open your `.code-workspace` file.

2.  Locate the generated multi-project launch configuration.

3.  Add explicit values for `mule.runtime.version` and `mule.jdk.version`.

    For example:

    ```json
    {
      "type": "mule-xml-debugger",
      "request": "launch",
      "name": "Run All 3 Projects (Explicit Versions)",
      "noDebug": true,
      "mule.projects": [
        "${workspaceFolder:test-run-config}",
        "${workspaceFolder:test-project1}",
        "${workspaceFolder:test-project2}"
      ],
      "mule.runtime.version": "4.8.2",
      "mule.jdk.version": "17"
    }
    ```

## Multi-Project Configuration Fields Reference

When MuleSoft Vibes generates a multi-project launch configuration in your `.code-workspace` file,
it includes fields that control execution mode and runtime behavior. Understanding these fields lets
you update configurations without re-creating them from scratch.

### Execution Mode

The `noDebug` field controls whether the configuration runs in run mode or debug mode:

- `noDebug: true` — starts all projects without attaching the debugger (run mode).

- `noDebug: false` or omitted — attaches the debugger to all projects (debug mode).

```json
{
  "type": "mule-xml-debugger",
  "request": "launch",
  "name": "Run All Projects",
  "noDebug": true, (1)
  "mule.projects": [
    "${workspaceFolder:main-project}",
    "${workspaceFolder:project-one}"
  ]
}
```

<table><tbody><tr><td><i data-value="1"></i><b>1</b></td><td>Set to <code>false</code> or remove this field to switch to debug mode.</td></tr></tbody></table>

To switch modes, ask MuleSoft Vibes to update the configuration, or edit `noDebug` directly in your
`.code-workspace` file.

### Runtime Arguments

MuleSoft Vibes doesn’t include runtime arguments in the generated launch configuration to keep the
setup simple. By default, configurations inherit the arguments from the
`Mule > Runtime: Default Arguments` setting in Anypoint Code Builder.

To customize runtime arguments for a specific configuration, add the `mule.runtime.args` field
directly to the launch configuration in your `.code-workspace` file:

```json
{
  "type": "mule-xml-debugger",
  "request": "launch",
  "name": "Run Multiple Projects",
  "noDebug": true,
  "mule.projects": [
    "${workspaceFolder:test-run-config}",
    "${workspaceFolder:test-project2}",
    "${workspaceFolder:test-project1}"
  ],
  "mule.runtime.args": "-M-Dmule.testingMode -M-XX:+UseStringDeduplication" (1)
}
```

<table><tbody><tr><td><i data-value="1"></i><b>1</b></td><td>All projects in the configuration use the same runtime arguments.</td></tr></tbody></table>

Alternatively, update the global default:

1.  Open **Settings**.

2.  Search for `Mule > Runtime: Default Arguments`.

3.  Add or update your arguments, for example `-M-Dencryption.key=my-key` or `-M-Denv=dev`.

For common runtime argument use cases, see
[Mule › Runtime: Default Arguments](https://docs.mulesoft.com/anypoint-code-builder/ref-mule-settings#setting-mule-args) and
[Defining and Securing Properties for a Mule Application](https://docs.mulesoft.com/anypoint-code-builder/int-create-secure-configs).

### Edit a Generated Configuration

<table><colgroup><col> <col></colgroup><thead><tr><th>To change</th><th>Do this</th></tr></thead><tbody><tr><td><p>Execution mode (run or debug)</p></td><td><p>Edit <code>noDebug</code> in the <code>.code-workspace</code> file, or ask MuleSoft Vibes to update the configuration.</p></td></tr><tr><td><p>Runtime arguments</p></td><td><p>Add <code>mule.runtime.args</code> to the launch configuration in your <code>.code-workspace</code> file, or update <code>Mule &gt; Runtime: Default Arguments</code> in <strong>Settings</strong>.</p></td></tr><tr><td><p>Mule runtime or JDK version</p></td><td><p>Edit <code>mule.runtime.version</code> or <code>mule.jdk.version</code> in the <code>.code-workspace</code> file. See <a href="#set-explicit-mule-and-jdk-versions">Set Explicit Mule and JDK Versions</a>.</p></td></tr><tr><td><p>Projects included in the run</p></td><td><p>Ask MuleSoft Vibes to update the configuration, or edit <code>mule.projects</code> directly in the <code>.code-workspace</code> file.</p></td></tr></tbody></table>

## See Also

- [MuleSoft Vibes for Anypoint Code Builder](https://docs.mulesoft.com/anypoint-code-builder/vibes-get-started)

- [Working with Workspaces](https://docs.mulesoft.com/anypoint-code-builder/start-workspaces)

- [Debugging Mule Applications](https://docs.mulesoft.com/anypoint-code-builder/int-debug-mule-apps)

- [Version Settings for Mule, Java, and Connectors](https://docs.mulesoft.com/anypoint-code-builder/int-versions)

- [MuleSoft Settings](https://docs.mulesoft.com/anypoint-code-builder/ref-mule-settings)

- [Defining and Securing Properties for a Mule Application](https://docs.mulesoft.com/anypoint-code-builder/int-create-secure-configs).