agentknock pairing status

agentknock pairing status reports whether this client has a pairing and whether it is ready to request secrets.

agentknock pairing status

The command takes no positional arguments. It reads pairing.json in the selected Agentknock directory without contacting the phone or relay.

Results

The result is plain text on standard output:

Status	Meaning
Pairing status: not paired.	No local pairing exists. Use pairing start to create one.
Pairing status: waiting for confirmation.	A pending pairing exists. After accepting it on the phone, use pairing finish. To discard it, use pairing abort.
Pairing status: active.	The client has completed pairing and can make requests to the phone.

For an unpaired or pending client, the status is followed by a suggested action and the appropriate pairing command. An active result prints only its status line.

An active result describes the local record. It doesn’t confirm that the phone is online or still accepts this client: a suspended or revoked client can still report active.

All three results exit successfully with status 0. The exit status alone doesn’t tell you whether the client is paired. An unreadable, malformed, or insecure pairing file produces an error instead of a not paired result. See local state requirements.