Skip to content

Support

Installation, first steps and answers to the most common questions.

Install the extension

The extension connects your Claude Code sessions to the app. It consists of a plugin, which registers the sessions, and a local server that the app starts.

  1. Install T'esperam in the Mac's Applications folder and open it. The plugin's hooks look for the app at that location.
  2. In the app, open the "Connect an agent" window (in French, "Brancher un agent"). It shows the command to run once in the terminal, with the port and token specific to your installation: 
    claude mcp add --transport http --scope user tesperam http://127.0.0.1:<port>/mcp --header "Authorization: Bearer <token>"
  3. Install the plugin bundled with the app: 
    claude plugin install tesperam@tesperam
  4. Restart the Claude Code sessions that are already open so that they pick up the plugin.

If you regenerate the token in the app, the window shows the removal command and then the new command to run.

First steps

  1. At first launch, allow access to Reminders: this is where your agents leave their requests, in the "Agents" list.
  2. In the app, allow your requests to be shared with the agents. Without this consent, the Reminders tools answer with a refusal.
  3. Start a Claude Code session: it appears in the fleet, and its requests in the app's Reminders list.
  4. For plan usage, add T'esperam's status line to the Claude Code settings, following the command the app suggests.
  5. On iPhone and iPad, open T'esperam with the same iCloud account: sessions and messages synchronize there.

Frequently asked questions

Does the app read my conversations with the agents?

No. It only knows the messages exchanged in its own thread, the reminders in the "Agents" list and the usage counters that Claude Code passes to it. The privacy policy details each piece of data.

No request appears in the app.

Check that access to Reminders is granted in the system settings, that the "Agents" list exists and that sharing requests with agents is allowed in the app. Then check that the command adding the server was run.

My sessions do not appear in the fleet.

The plugin must be installed and the sessions restarted after installation. The app must also be open and located in the Applications folder.

The port or the token no longer works.

Reopen the "Connect an agent" window: it gives the command that removes the old declaration, then the up-to-date command to add it again.

Messages do not synchronize between my devices.

The devices must use the same iCloud account, with iCloud Drive on and a connection available. The app shows the synchronization state in its settings.

How do I manage or cancel the subscription?

The subscription is managed by Apple, in your account settings on the App Store (apps.apple.com/account/subscriptions).

How do I erase my data?

Delete the app, then its data in the iCloud settings; the full procedure is in the privacy policy.

Contact

For a question, a bug report or a request about your data, write to contact@tesperam.app. Please include the app version and your system version.

LIANT, 5 avenue Jean Jaurès, 34600 Bédarieux, France, RCS Béziers 908 976 897.