Skip to content
AgentknockAgentknock Docs

agentknock pairing abort

agentknock pairing abort discards a pending pairing from this client. Use it when you reject or abandon an attempt started with pairing start.

Terminal window
agentknock pairing abort

The command takes no arguments. It deletes the local pending pairing without contacting the phone or relay, then prints a confirmation to standard output. The client can immediately start a new pairing.

Aborting doesn’t dismiss the attempt on the phone. Reject the in-progress request there too, if it appears. See Pair a client for the pairing procedure and verification guidance.

The command returns an error if there is no pending pairing. An active pairing is left unchanged; use pairing remove to remove it. Repeating pairing abort after a successful abort also returns an error because the pending pairing no longer exists.