CLI

Control your home lab dev box from your phone

Whatever's running in the rack or on a shelf — a NAS box, a mini PC, a Raspberry Pi — codemote-cli reaches the workspace on it from your pocket.

Self-hosted setups usually mean a machine with no monitor attached — a mini PC, an old laptop repurposed as a server, or a Raspberry Pi. codemote-cli runs on any of them and pairs your phone directly to a project folder there.

Install and start

$npm install -g codemote-cli

$codemote start ~/projects/home-lab

Scan the QR code once, and pairing persists — you don’t need to be on the same network as your home lab to reconnect later, since the connection is tunnelled.

Away from home, same access

Because the tunnel is outbound from the server, there’s no port forwarding or dynamic DNS to configure on your router. Check a log, restart a service, or pull the latest changes from your phone over cellular, exactly as if you were standing next to the rack.

This is workspace access, not general server administration — you’re driving the project you started the session in, the same way the extension drives a VS Code window.

Runs on a Raspberry Pi as easily as a full server — anywhere Node.js 18+ runs.

Questions

Does this work on a Raspberry Pi?

Yes. codemote-cli only needs Node.js 18 or newer, which runs fine on a Raspberry Pi — install it, run codemote start, and pair your phone the same way as any other machine.

Do I need to configure my router?

No. Pairing uses an outbound dev tunnel from the server, so there's no port forwarding or dynamic DNS setup needed.

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