Myrax docs

Connector commands

One binary, a small set of commands. Three of them cover normal use; the rest exist for diagnosing a machine, moving a workspace, or getting out.

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

CommandWhat 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 daemonHeartbeat every 15 seconds, plus one queue check per tick. Leave it running while you work. Ctrl-C stops it.
myrax-connector doctorChecks 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

CommandWhat it does
myrax-connector detectLists detected agents as JSON. Useful when a script needs the facts.
myrax-connector statusLocal pairing state, without printing the token.
myrax-connector whoamiWhich server and account this machine is paired with.
myrax-connector queueLists briefs waiting for this computer, without running them.
myrax-connector heartbeatSends 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

CommandWhat 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

VariableEffect
MYRAX_WORKSPACEWhere workspaces are created. Defaults to ~/.myrax/workspaces. Point it outside any git repository.
MYRAX_SERVERBase URL used by the installer.
CALESTIX_CONNECTOR_HOMELegacy 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.