Retain / User Guide
Back to User Guide
Getting started

Connect Claude Code or Codex

Invalid Date
3 min read

Connecting your coding agent is part of setting up Retain, not an add-on. Retain is where your agent finds what was said and decided in your meetings, and where it reports the builds it does for you. This page shows how to connect Claude Code, Codex, and the Claude and ChatGPT apps, and what you can ask once you have.

Why connect your agent

Without Retain, your agent knows your code and nothing else: not the meeting where the scope changed, not the commitment you made last week. Connected, it can search your meetings, threads and email, read a design before it builds, and write back what you confirm.

It also works the other way. When your agent builds a build packet, its progress and pull requests show up in Retain, so the Work list stays true without anyone retyping it. What your agent can do with Retain has the full list.

Where the steps are

In the Retain Mac app, open Settings and choose AI assistants. Pick Claude, Claude Code, ChatGPT or Codex at the top. The page shows that assistant's steps, with a Copy button beside each command and the connector URL.

The page does not show whether an assistant is connected, so you check by asking it something (below).

Connect Claude Code

Claude Code gets the Retain plugin: the skills your agent reads, the slash commands you type, and the connector. Run these in a terminal. They are safe to run again.

			claude plugin marketplace add ryanrapp/retain-skills
claude plugin install retain@retain
		

Restart Claude Code and sign in to Retain when it asks. The /retain commands appear after the restart. To get newer skills later, run the update the page shows and restart again.

Or choose Save setup script… on the page and double-click the file it saves. It runs the same commands, signs you in in your browser, removes itself when it finishes, and does not need your password. Review commands shows what it holds. It also installs the small tool your agent uses for builds and syncing, which you never type yourself.

Connect Codex

Codex gets the same plugin, with Retain's connector in it. You need Codex 0.162.1 or later. Run these in a terminal; the last one signs in to Retain in your browser.

			codex plugin marketplace add ryanrapp/retain-skills
codex plugin add retain@retain
codex mcp login retain
		

Restart Codex and start a new conversation. Save setup script… works here too, and the page has a section for older Codex versions.

Connect the Claude and ChatGPT apps

These two connect through Retain's connector address, with no plugin and no terminal.

  • Claude. In Claude, open Settings, then Connectors, and choose Add custom connector. Paste the connector URL from the Retain page and sign in to Retain. If Claude asks how it should identify itself, choose Claude's published identity.
  • ChatGPT. In ChatGPT, open Settings, then Apps, turn on Developer mode under Advanced settings, and choose Create app. Paste the connector URL as the MCP server URL, choose OAuth, and sign in.

Claude and ChatGPT can search and read your Retain and save what you confirm. The slash commands and builds need a coding agent working in your repository, so they belong to Claude Code and Codex.

Check that it works

Start a new conversation in your assistant and ask something only Retain knows:

What did we decide about pricing in my recent meetings?

It should answer from your meetings and name them. This question only searches; it saves nothing. From there, try asking for your open tasks, or run /retain:sync in Claude Code to see today's digest. In Codex, type $retain-sync or ask for Retain Sync.

For a daily check, the page offers a request to paste into Claude Code or Codex that schedules the sync each weekday at 6:45. Run it once by hand first and choose Always allow, so a permission prompt does not stop the scheduled run. It runs only while the app is open and your computer is awake. Retain makes your morning digest either way.

Need help?

Can't find what you're looking for? Contact our support team for a quick reply.

Contact Support