Troubleshooting

“devtunnel: command not found” — how to install it for CodeMote

June 22, 2026 · 3 min read

If CodeMote can't start a session because devtunnel isn't on your PATH, here's how to install Microsoft's dev tunnels CLI on macOS, Windows and Linux and verify it works.

CodeMote relies on Microsoft’s free devtunnel CLI to build the secure link between your phone and your computer. If you see devtunnel: command not found— or CodeMote can’t start a session — the tool just isn’t on your PATHyet. Here’s the fix.

Install devtunnel

macOS

$brew install --cask devtunnel

Windows

$winget install Microsoft.devtunnel

Linux

$curl -sL https://aka.ms/DevTunnelCliInstall | bash

Verify it’s on your PATH

Open a fresh terminal and run:

$devtunnel --version

If you get a version number, you’re set. If it still says “not found,” close and reopen your terminal (and VS Code) so the updated PATH is picked up.

Sign in once

devtunnel needs you to authorize your machine to host a tunnel. Sign in with whichever account you prefer:

$devtunnel user login --github

$devtunnel user login --microsoft

This is notVS Code’s “Turn on Remote Tunnel Access” menu item. CodeMote uses the standalone devtunnelCLI — don’t enable the VS Code menu option for this.

Start your session

Back in VS Code, run CodeMote: Start Mobile Session from the Command Palette and scan the QR code. Still stuck? The full tutorial has every step, or reach outand I’ll help.

Take your dev environment with you.

Drive your AI agents, terminals and Git from your phone — with no cloud copy of your code.

Get the app