OpenTalon Help

Connect your agent, get your workspace open again, and keep your tasks in sync.

Open or manage a support ticket

Get help setting up OpenTalon or troubleshooting an issue on Mac, iPhone, or iPad. Sign in to create a ticket or reply to an existing conversation.

Go to Protomota Support

Connect an agent

OpenTalon uses the Claude Code or Codex sign-in you already have on your Mac.

  1. Install and sign in to Claude Code or Codex on the same Mac as OpenTalon.
  2. In OpenTalon, go to Settings → Agent connection. Turn on Enable MCP connection, then click Test connection.

Claude Code

Select Claude Code and click Save project connection…. In Claude, open the Code tab, select the same folder, and approve the OpenTalon connection when prompted.

Codex

In Codex, open Settings → MCP servers and add a server. Choose STDIO, copy the fields from OpenTalon’s Codex setup, then save and reload the connection.

Ask your agent to “List my OpenTalon projects.” To hand off work from OpenTalon, choose the default agent and working folder in Settings → Task agent, then move a card to Sent to agent.

Troubleshooting

The agent can’t connect

Open OpenTalon from Applications. Run Test connection in Settings → Agent connection. If the test passes but your agent can’t see OpenTalon, check the approved project connection in Claude Code or reload the STDIO server in Codex. If the agent can see OpenTalon but can’t run a task, check the provider sign-in and the working folder under Task agent.

OpenTalon says the workspace is already open

Quit the other copy of OpenTalon, then click Retry. If it’s running in the background, find the other copy in Activity Monitor and choose Stop → Quit. On version 1.0.2 or earlier, reopen OpenTalon after the other copy quits.

A task stopped or is waiting for input

Open the card and check the agent activity. Answer any pending permission request or use the conversation controls to review where the agent left off. Interrupted work waits for your review.

Sync and backups

Tasks haven’t reached iPhone or iPad

Open OpenTalon on the Mac and mobile device using the same Apple Account. Use Settings → iCloud Sync → Check Now on each device. A large first sync can take a few minutes. You can share sync diagnostics from mobile Settings if the workspace still doesn’t appear.

Export or restore your workspace

On Mac, go to Settings → Your data & backups. Use Export Backup… to save a copy, or Import / Restore… to review a backup before restoring it. Daily backups are available in Settings.

Send feedback

Tell us what happened, how to reproduce it, and which OpenTalon and macOS versions you’re using. For mobile issues, include your device and iOS or iPadOS version.

Send feedback