Skip to content

Working with west

You can interact with west in several ways, either by calling commands in the Command Palette or by using the Source control UI.

How to initialize a west workspace

A new west workspace is created by using the west init command. To use the command from the extension:

  1. Open the Command Palette and type nRF Connect: West Init.
  2. Browse to the folder where you want to initialize a west workspace.
  3. Choose nrf or zephyr, or a custom repository.
  4. Choose which version tag you want to work with.

West begins to initialize the workspace in the terminal output.

How to manually trigger status update

To trigger a status update, use one of the following options:

  • Open the Source Control View and click the refresh button on the west source control line in Source control UI.

    Refresh west modules button in the Source Control View

  • Open the Command Palette and type nRF Connect: West Refresh.

How to update a west workspace

Use the west update command to match your west workspace state with the state of the west manifest file. Whenever you check out a different revision in your manifest repository, run west update to make sure your workspace contains the project repositories that the new revision expects.

To update a west workspace:

  1. Open the Command Palette and type nRF Connect: West Update.
  2. Choose the location of your project repository.

West begins to update automatically.

How to change the west manifest

This option is useful for those who use upstream Zephyr and need to frequently switch between the two manifests or different versions. To change the current west manifest:

  1. Use one of the following options to access the menu for setting the active manifest:

  2. Click on the manifest path icon located towards the top of the Source Control View.

    Managing west in the Source Control View

  3. Open the Command Palette and type nRF Connect: West Set Active Manifest.

  4. Choose between either the nRF Connect or Zephyr manifest.