Connect a development machine

A connected machine runs the Quadratique daemon, reports available coding Runtimes and models, and claims work delegated to Agents bound to it.

Before you connect

This guide assumes that machined is installed. Install and authenticate at least one supported coding Runtime on the machine, such as Codex CLI or Claude Code. The Runtime’s credentials remain local.

You can connect a machine with no detected Runtime, but it cannot host an Agent until a later scan reports an available Runtime and model.

Generate a connect token

1. Open the workspace menu and select Settings.
2. Open Machines.
3. Select Generate connect code.
4. Copy the token. It is shown once and expires after 10 minutes.

Generating a token does not connect a machine by itself.

Connect from the terminal

Run:

machined connect <connect-token>

Replace <connect-token> with the token from Machines settings. The token is single-use. Replaying an accepted token or using an expired or malformed one does not create a machine or credential.

On first connection, machined:

1. creates a stable installation identifier at ~/.quadratique/machine.id;
2. exchanges the token for a machine-scoped credential;
3. registers the machine using its hostname as the initial display name;
4. scans for supported Runtimes and models; and
5. begins presence heartbeats and work claims.

Keep the daemon running so the machine remains online and can claim delegated work.

Confirm the connection

Return to Settings → Machines. The machine row shows:

• display name and owner;
• online or offline presence;
• detected Runtimes and models; and
• active execution slots and concurrency cap.

The default concurrency cap is 2. Additional delegated issues remain queued.

Reconnect the same installation

If the machine loses its credential but keeps ~/.quadratique/machine.id, generate a fresh connect token and run the connect command again. Quadratique reconnects the existing machine and revokes its previous credentials. Its display name does not determine its identity.

Only the machine owner or a workspace administrator can reconnect an existing installation identifier.

Sharing and host access

A machine is private to its owner by default. Sharing it lets shared Agents run on that machine for authorized workspace members.

Agent runs inherit the machine’s host network access. Review this exposure before sharing a machine or Agent. Runtime credentials and environment secrets remain on the host and are not stored in Quadratique.

Remove a machine

Removing a machine revokes its daemon credential, suspends Agents bound to its Runtimes, and clears work that is still queued for those Agents. It does not rewrite snapshots of runs already active.