CLI reference

Quadratique’s command-line surface has two responsibilities:

• machined connects a development machine and runs the Agent work daemon.
• quad check defines and executes repository checks locally and for pull requests.

This reference covers the commands needed for machine connection and repository checks.

machined connect

Connect the current installation to a workspace and start the daemon loop.

machined connect <connect-token>

Option

<connect-token> : Required positional one-time token generated from Workspace settings → Machines. It expires after 10 minutes and cannot be replayed after a successful exchange.

Local state

The daemon persists the installation UUID at:

~/.quadratique/machine.id

The specification requires the identifier and machine credential files to use owner-only permissions (0600). The final credential file path is not yet part of the public contract.

Daemon behavior

While running, machined:

• reports machine presence;
• discovers supported Runtimes and models;
• claims queued work up to the configured concurrency cap;
• runs each attempt in an isolated working copy;
• renews active run leases;
• streams bounded transcript output; and
• reports completion, failure, or acknowledged cancellation.

quad check

Run a repository’s Quadratique checks or initialize its check configuration:

quad check
quad check init

quad check runs the repository’s Quadratique check pipeline locally. quad check init creates the initial pipeline configuration.