Your first Relay
With Relay mode, the agent you are talking to asks another AI tool, called the teammate, for advice, then reports its reply back in your conversation, without copying and pasting. This page walks you through a first exchange and its follow-up; the full Relay guide covers the rest.
Before you start
- PALABRE installed, along with Codex and Claude Code, each signed in with its usual account.
- A trusted configuration:
palabre initcreates and trusts it;palabre doctorchecks everything without querying a model. - The Palabre skill accessible to your assistant. It can reread the current package instructions before the task without asking you to synchronize or restart; initial skill discovery depends on your application.
These preparations are yours: an agent can guide you, but you decide on and confirm installation, sign-in and approval. Your request and the files read are sent to the chosen tool; avoid sensitive data for this first try.
1. Ask for advice
From a Codex conversation opened in your project folder, send for example:
Use PALABRE to ask Claude Code for its opinion on this fictional plan, without changing files. Fictional plan: 1) publish the website's new Pricing page; 2) check all its links; 3) test its contact form. I want one main risk and one improvement. Create a new conversation and keep it for follow-up.
This fictional plan is in the message: no website or file to prepare. From Claude Code, send the same text with "Claude Code" replaced by "Codex".
From Codex Desktop, Codex asks you to allow the PALABRE command outside its sandbox. Read it and approve this time only: no full access, no permanent rule. Each later command asks for its own approval. The "Approve on my behalf" setting may accept without showing you the request: leave it disabled if you want to approve yourself, because a launched command does not prove that you clicked. This path has been verified on Windows; for other setups, see the path from Codex.
The exchange may take a while: its duration depends on the tools, models and your quotas.
2. Recognize success
Your agent reports back in the original conversation:
- the teammate's opinion: one risk and one improvement, in plain words;
- the mode: background. The teammate worked without a window; PALABRE requests read-only access and limits its tools during the call, under the conditions described in the guide;
- receipt, separate from the result: receiving a reply does not prove the opinion is right or the task succeeded. The agent separates what arrived, what the teammate concludes and the evidence supporting it. A reply can also be a refusal;
- the record: a
.relay.mdfile in the exports folder (.palabre/by default). Ask "Show me the export of this exchange" to read it.
View the conversation in Codex
To view it in the app, simply say:
Show me the teammate's conversation in Codex.
After this request, your agent may launch it with the permissions required by its host. If Claude Code Desktop presents a command with a Run button, click it: the link alone may not be clickable in that interface. The agent prepares palabre relay open; you do not need to find an identifier or choose a technical option. Opening sends no message and does not make the conversation writable.
3. Continue with the same teammate
Continue with the same teammate: detail the main risk and suggest a simple check, without changing files.
The agent resumes the conversation created in step 1: no new conversation, nothing to copy. If Claude is already using this conversation, Relay may be unable to reach it: your agent explains the limitation and the next possible step, without asking you to copy its identifier or automatically resending the request.
In a new conversation, your agent no longer has this thread. Say "Find the recent Relay exchange about the Pricing page": it checks the exports and asks you to confirm the exchange before continuing (Find a recent exchange).
If something blocks
- Untrusted configuration (
config-untrusted): nothing is sent. Read the file shown, then trust it yourself withpalabre config --config <file> --trust-config, replacing<file>with the path shown (in quotes if it contains spaces), before asking again. The agent does not trust it for you. - Unknown delivery or message without reply (
unknown,persisted-no-reply): do not resend the request, it may already have arrived. Your agent first checks what it can in the conversation or export and explains what is established; PALABRE never resends automatically. See Outcome and delivery. - The teammate is waiting for permission: your agent cannot grant it. It tells you where to approve and stops; continuing will be a new request from you.
Choose where the teammate works
This first try creates a background teammate: it replies without a window, with the limited tools described above. The CLI alone also uses background by default.
To continue, just describe the work you need. The agent checks how to reach the same conversation and respects your preference. It can continue in a Codex conversation already in use, after checking and explaining its usual permissions, when existing authorization allows it. A review still makes no changes. If you explicitly chose background, an exception remains your decision; if you require limited read-only tools, that path remains mandatory. No switch or resend after a refused send. The full Relay guide explains these choices.
Go further
The full Relay guide describes opening conversations in the applications, commands without an agent, the path from Codex, verified systems, statuses and experimental or frozen features (--write, Mission, review). On a new machine, start with Change machines.