UiPath Documentation
maestro
latest
false
Maestro Orchestrate user guide

VS Code extension

Every command, keyboard shortcut, and setting of the UiPath Maestro extension for VS Code, and the fixes for sign-in and other common problems.

This page lists what the UiPath Maestro extension for Visual Studio Code (VS Code) offers: its commands, keyboard shortcuts, settings, and fixes for common problems. Build in VS Code describes how to install the extension, sign in, and build a process.

Commands and keyboard shortcuts​

Run any command from the Command Palette (Ctrl/Cmd+Shift+P). The flow editor shortcuts apply only when a .flow file is the active editor.

Flow editor​

CommandDefault keybinding
Flow: New FlowCtrl/Cmd+Alt+N
Flow: Open FlowCtrl/Cmd+Alt+O
Flow: Save FlowCtrl/Cmd+S
Flow: Save Flow AsCtrl/Cmd+Shift+S
Flow: UndoCtrl/Cmd+Z
Flow: RedoCtrl+Y / Cmd+Shift+Z
Flow: Zoom InCtrl/Cmd+=
Flow: Zoom OutCtrl/Cmd+-
Flow: Reset ZoomCtrl/Cmd+0
Flow: Fit to ScreenCtrl/Cmd+Shift+F
Flow: Validate FlowCtrl/Cmd+Shift+V
Flow: Export FlowNone

UiPath platform​

CommandDescription
UiPath: Sign InSign in to UiPath.
UiPath: Sign OutSign out and clear the cached session.
UiPath: Select EnvironmentChoose the UiPath environment.
UiPath: Select TenantChoose the tenant or organization.
UiPath: Create New ProjectAdd a project to the solution. Choose Data Fabric to create an entity project.
UiPath: New FileAdd a file to a project. Choose Entity File to add an entity.
UiPath: Add Entity FileAdd another entity to an existing entity project. Available once the solution has one.
UiPath: PackageBuild a .uipx solution from the workspace.
UiPath: DeployUpload a packaged solution to Orchestrator.
UiPath: Package & DeployPackage and deploy in one step.
UiPath: Switch Deploy TargetChange the destination folder.
UiPath: Generate .env FileWrite a CLI-compatible .env file.
UiPath: RefreshRefresh the Connect tree.
UiPath: Show Output LogOpen the UiPath output channel.
UiPath: Getting StartedOpen the Getting Started walkthrough.

For the full set of canvas shortcuts, refer to Keyboard shortcuts.

Settings​

Configure the extension in VS Code settings.

uipath.environment​

The UiPath environment used when signing in. Default is cloud. An existing CLI session takes precedence if it points elsewhere.

uipath.autoActivateDeployment​

Activates a solution deployment after a successful deploy. Default is true.

uipath.cli.path​

An absolute path to the UiPath CLI binary (uip). Leave it empty to find uip on your PATH. Set this when the CLI is installed in a location that isn't on your PATH.

uipath.telemetry.enabled​

Sends anonymized usage telemetry. Default is true. The extension also honors VS Code's global telemetry.telemetryLevel. Turning off either setting disables telemetry.

Troubleshooting​

Sign-in fails​

Sign-in fails when the OAuth callback port is busy or the CLI lost its session.

  • Port in use. The CLI uses port 8104 on localhost for the callback. If a stale process holds it, free the port and sign in again. On macOS or Linux, run lsof -ti :8104 | xargs kill -9. On Windows, run netstat -ano | findstr :8104, then taskkill /F /PID <id>.
  • Stale session. Run UiPath: Sign Out, then UiPath: Sign In again to force a fresh sign-in.
  • Read the log. Run UiPath: Show Output Log and check the UiPath output channel for sign-in errors.

The CLI isn't found​

The extension shells out to uip. If it can't find the binary, sign-in and packaging fail.

  1. Confirm the CLI is installed by running uip --version in a terminal.
  2. If uip isn't on your PATH, set uipath.cli.path to the absolute path of the binary.
  3. If the CLI isn't installed at all, run UiPath: Sign In and accept the install prompt, or install it manually with npm install -g @uipath/cli. This requires Node.js and npm on your PATH.

Remote workspaces don't see the CLI​

In WSL, SSH, Codespaces, and dev container workspaces, the extension runs on the remote host, not your local machine. The uip binary must be installed on that host. A CLI installed on your local Windows or macOS machine isn't visible to the extension. Install the CLI in the remote workspace, then sign in again.

Deployment doesn't activate​

By default, the extension activates a deployment after a successful deploy. If a deployment uploads but doesn't activate, confirm that uipath.autoActivateDeployment is turned on.

Next steps​

Was this page helpful?

Connect

Need help? Support(opens in new window)

Want to learn? UiPath Academy(opens in new window)

Have questions? UiPath Forum(opens in new window)

Stay updated