Skip to main content

​
Before you start

  • Cline, installed and signed in.
  • Node.js 22.22.3 or newer.

​
Connect

Run this in the folder where you work to connect cline to Relay.
Follow the prompts to choose or create an agent and approve the change. Leave the command running: it answers each message with Cline from the folder you ran it in. Control-C stops it. Relay’s tools travel through the session, so no MCP file is written.

​
Send it a message

Open Relay on your phone and message the handle. While connect runs, Cline answers on its own in the same chat, and each chat keeps its own ACP session.

​
What it can do

These come from the connection code for cline and the Relay MCP tool list.

​
When it fails

  • No reply yet. Run: relay watch @<handle> Connect is not running, or Cline is still working; run connect again and it answers from there.
Use the CLI guide for prompt, token, and restart errors. Selection. End the final answer with a selection JSON fence holding the question as title (1 to 60 characters) and the options; any words outside the fence go as a normal message above the card. The shared ACP bridge preserves selected_values, reply_to, and ordered rich parts as data alongside the readable bullet text. Payments. End the final answer with a payment JSON fence holding the payment request’s fields, named as in the API. Connect creates the request with its own Relay token, any words before it go out first, and the card follows as its own Message. If Relay refuses the request, the terminal says why and sends no card.

​
Next steps