CLI Reference

jarvs serve

Start the JarVS server.

jarvs serve

When you run this command, the server:

1. Starts an HTTP server on the configured host and port.
2. Advertises itself on the local network via mDNS so your Apple Vision Pro can discover it automatically.
3. Detects available code editor backends (e.g. code CLI for VS Code).
4. Manages VSCode Server sessions and WebSocket connections for each open project.

macOS

On Mac you typically don't need to run this manually. The JarVS menu bar app starts the server automatically in the background.

Linux

The install script sets up a systemd user service that runs jarvs serve automatically:

# Check if the service is running
systemctl --user status jarvs-server

# Start the service
systemctl --user start jarvs-server

# View logs
journalctl --user -u jarvs-server -f

jarvs pair

Generate a pairing code to manually connect your Apple Vision Pro to JarVS. Useful on Linux or when automatic mDNS discovery isn't working.

jarvs pair

How it works

1. The command connects to a running JarVS server and generates a short numeric code.
2. The code is displayed in your terminal with a countdown timer.
3. Open JarVS on Apple Vision Pro, tap Enter code manually, and type the code.
4. Once paired, your Apple Vision Pro remembers this server for future connections.

The server must already be running before you can generate a code. When a code expires, a new one is generated automatically — you don't need to re-run the command. If too many failed attempts are made, the code is invalidated early and a fresh one replaces it.

When to use this

• Linux — mDNS auto-discovery may not work on all setups, so manual pairing is the recommended way to connect.
• Network issues — if your Apple Vision Pro doesn't automatically discover the server.

Example

$ jarvs pair

  Pairing code:  4 8 2 9 1 6

  Enter this code on your Apple Vision Pro to pair.

  Expires in 4:58

Global options