Agent

The Agent is a small outbound-only process that runs on your machine. Supported platform: macOS arm64.

Install and start

curl -fsSL https://ekord.app/install | sh
ekord

After installation the ekord command is available. Start it from the directory you want to use as the workspace root, or pass --root DIR.

Pairing

On first start the Agent prints a short pairing code and opens the browser. Approve the code while signed in to your EKORD account. If the code expires, start the Agent again for a new one.

Credential persistence

After pairing, the Agent stores a device credential under ~/.ekord/. It is reused on restart; no new pairing is required.

Restart and reconnect

Stop the Agent with Ctrl-C and start it again with ekord. It reconnects automatically using the stored credential and returns to ready.

Force re-pair

Run ekord --pair to start a new pairing ceremony. Deleting the stored credential has the same effect.

Status and version

The Agent prints paired, connecting, ready, and error states. ekord --version prints the installed version.

Workspace root

Relative paths are resolved against the workspace root; absolute paths are used as-is. The Agent runs under your operating-system user permissions.

Stop

Stopping the Agent removes remote execution availability until it is started again.