The Connector is one binary with a small set of commands. You need three of them for normal use; the rest exist for diagnosing a machine, moving a workspace, or getting out.
Day to day
| Command | What it does |
|---|---|
myrax-connector pair <url> | Prints a six-digit code and waits for it to be claimed in the dashboard. The token it receives is saved on this machine. |
myrax-connector daemon | Heartbeat every 15 seconds, plus one queue check per tick. Leave it running while you work. Ctrl-C stops it. |
myrax-connector doctor | Checks Node, your home folder, each agent, the browser, a local model server, and the pairing. Exit code is non-zero while something is wrong. |
Inspecting
| Command | What it does |
|---|---|
myrax-connector detect | Lists detected agents as JSON. Useful when a script needs the facts. |
myrax-connector status | Local pairing state, without printing the token. |
myrax-connector whoami | Which server and account this machine is paired with. |
myrax-connector queue | Lists briefs waiting for this computer, without running them. |
myrax-connector heartbeat | Sends one heartbeat now, instead of waiting for the next tick. |
Running work by hand
myrax-connector work claims queued briefs and runs them once, then exits. It is the same code path the daemon calls each cycle, so you can use it to watch a build in the foreground when something is misbehaving.
Moving a workspace
| Command | What it does |
|---|---|
myrax-connector repo [dir] | Maps a folder: branch, dirty state, detected stack, and the paths it will treat as sensitive. |
myrax-connector export [dir] [name] | Packs a workspace into a zip, with secrets and dependencies excluded. |
myrax-connector rewind <dir> <ref> | Takes the workspace back to a checkpoint. A real git operation; read the ref first. |
Environment
| Variable | Effect |
|---|---|
MYRAX_WORKSPACE | Where workspaces are created. Defaults to ~/.myrax/workspaces. Point it outside any git repository. |
MYRAX_SERVER | Base URL used by the installer. |
CALESTIX_CONNECTOR_HOME | Legacy state directory override. Leave it alone unless you need it. |
Removing it
myrax-connector uninstall --yes
This removes the install and the local pairing. Your device row stays in the dashboard until you revoke it there, so an uninstall cannot quietly leave an account holder with a device they cannot see or remove.
The full setup path is in Getting started.

