Support

Earside for iPhone · Version française

Earside reads your coding agent's results into your AirPods and types your spoken replies into the session on your Mac. It works with Claude Code, Codex, Gemini CLI and other terminal agents.

What you need

An iPhone with iOS 26 or later, and AirPods (or another Bluetooth headset) for stem presses.
A Mac where you run your agent in a terminal.

Set up

Install Earside on your Mac:
```
curl -fsSL https://earside.app/install | sh
```
The installer ends by showing a pairing code. Already installed? Run earside pair.
Scan the code with the iPhone Camera and open it in Earside. The app shows Connected.
Send a session to your phone: type ! earside in your agent's session, or start one already sent with earside claude (or earside codex, earside gemini…). It appears in the app's session list. ! earside in a sent session takes it off your phone.

Your iPhone and your Mac don't need to be on the same network.

No Mac yet? Tap Try a demo on the first screen. A demo session reads a sample result and answers your replies, all on the iPhone. End demo takes you back.

Use it

Open the app once and tap Arm before you leave. You can then lock the phone.
When a session finishes a turn, you hear its label and a short summary, like “falcon: all tests pass…”.
Press the stem once to answer, then speak. Earside reads your reply back (“To falcon: …”) and sends it after two seconds.
Press twice to hear the full result or repeat it. Press three times, or say “cancel”, to stop a reply before it is sent.
Start your reply with a session's name to answer another session: “juniper, run the tests”.
Say “sessions” to hear which sessions are working, waiting or done.
Listening to music? Choose With music in Settings. Results are read over your music, and you reply with Siri: “Hey Siri, reply in Earside”.

Siri shortcuts: “Reply in Earside”, “Read my agent in Earside”, “Arm Earside”.

Troubleshooting

The app says Offline

Check that the iPhone has a connection. If it keeps failing, pair again: run earside pair on the Mac and scan the new code.

My session isn't in the list

Type ! earside in the session, or start it with earside <agent>. Run earside status on the Mac to check the pairing.

“Disarmed” or stem presses do nothing

A phone call, Siri or an alarm can stop the microphone. Earside then sends a notification. Open the app to arm it again. Stem presses work only in the Earside only mode.

Siri says Earside replies need your AirPods

Siri replies are accepted only while a Bluetooth headset is connected, so nobody can answer your sessions from your locked phone's speaker.

The voice sounds robotic

Download a Premium or Enhanced voice in iOS Settings › Accessibility › Spoken Content › Voices, then pick it in Earside's Settings.

Contact

Questions, bugs and ideas: github.com/pFournet/earside/issues. Read how your data is handled in the privacy policy.

Assistance

Earside lit les résultats de ton agent de code dans tes AirPods et tape tes réponses parlées dans la session sur ton Mac. Il fonctionne avec Claude Code, Codex, Gemini CLI et d'autres agents en terminal.

Ce qu'il te faut

Un iPhone sous iOS 26 ou plus récent, et des AirPods (ou un autre casque Bluetooth) pour les appuis sur la tige.
Un Mac sur lequel tu lances ton agent dans un terminal.

Installation

Installe Earside sur ton Mac :
```
curl -fsSL https://earside.app/install | sh
```
L'installation se termine par un code de jumelage. Déjà installé ? Lance earside pair.
Scanne le code avec l'appareil photo de l'iPhone et ouvre-le dans Earside. L'app affiche Connected.
Envoie une session sur ton téléphone : tape ! earside dans la session de ton agent, ou démarres-en une déjà envoyée avec earside claude (ou earside codex, earside gemini…). Elle apparaît dans la liste de l'app. ! earside dans une session envoyée la retire de ton téléphone.

Ton iPhone et ton Mac n'ont pas besoin d'être sur le même réseau.

Pas encore de Mac ? Touche Essayer une démo sur le premier écran. Une session de démo lit un résultat d'exemple et répond à tes réponses, entièrement sur l'iPhone. Terminer la démo te ramène au début.

Utilisation

Ouvre l'app une fois et touche Arm avant de partir. Tu peux ensuite verrouiller le téléphone.
Quand une session termine un tour, tu entends son nom et un court résumé, par exemple « falcon : tous les tests passent… ».
Un appui sur la tige pour répondre, puis parle. Earside relit ta réponse (« À falcon : … ») et l'envoie après deux secondes.
Deux appuis pour entendre le résultat complet ou le répéter. Trois appuis, ou dis « annule », pour arrêter une réponse avant l'envoi.
Commence ta réponse par le nom d'une session pour répondre à une autre : « juniper, lance les tests ».
Dis « sessions » pour savoir quelles sessions travaillent, attendent ou ont fini.
Tu écoutes de la musique ? Choisis With music dans les réglages. Les résultats sont lus par-dessus ta musique et tu réponds avec Siri : « Dis Siri, répondre dans Earside ».

Raccourcis Siri : « Répondre dans Earside », « Lis la réponse de mon agent dans Earside », « Arme Earside ».

Dépannage

L'app affiche Offline

Vérifie que l'iPhone a du réseau. Si ça échoue encore, jumelle à nouveau : lance earside pair sur le Mac et scanne le nouveau code.

Ma session n'est pas dans la liste

Tape ! earside dans la session, ou lance-la avec earside <agent>. Lance earside status sur le Mac pour vérifier le jumelage.

« Disarmed » ou les appuis ne font rien

Un appel, Siri ou une alarme peuvent couper le micro. Earside envoie alors une notification. Ouvre l'app pour le réarmer. Les appuis sur la tige ne marchent qu'en mode Earside only.

Siri dit que les réponses Earside ont besoin de tes AirPods

Les réponses par Siri ne sont acceptées qu'avec un casque Bluetooth connecté, pour que personne ne réponde à tes sessions depuis le haut-parleur de ton téléphone verrouillé.

La voix sonne robotique

Télécharge une voix Premium ou Améliorée dans Réglages iOS › Accessibilité › Contenu énoncé › Voix, puis choisis-la dans les réglages d'Earside.

Contact

Questions, bugs et idées : github.com/pFournet/earside/issues. Pour tes données, lis la politique de confidentialité.