Help with Armada.

Most questions are answered below. If yours isn't, email support@armadafleet.dev and we'll get back to you, usually within two business days.

Getting started

What you need

• A Mac with Apple silicon running macOS 12 or later.
• At least one agent installed and signed in on that Mac: Claude Code, Codex or OpenCode. Plain shell terminals work with no agent at all.
• For the companion app, an iPhone running iOS 17 or later.

Pair your iPhone

1. On the Mac, open Settings → iPhone and turn on phone access. A QR code appears.
2. Scan it with the iPhone camera, or from the Armada app's pairing screen.
3. Confirm the pairing on the Mac. Each code works once and expires after two minutes.

Troubleshooting

The phone can't reach my Mac

• Check that phone access is still on in Settings → iPhone on the Mac, and that Armada is running.
• At home, both devices need to be on the same network. Some guest and office networks block devices from seeing each other; the relay covers that case once you're paired.
• If a firewall is on, allow Armada to accept incoming connections. It listens on port 7419 (or the next free port up to 7424).

I'm not getting notifications

• Make sure notifications are allowed for Armada in the iPhone's Settings → Notifications.
• Alerts only go to a phone when the Armada app isn't already on screen, so you won't get a push for something you're looking at.
• Away from home, alerts travel through the relay. If the Mac is asleep or offline, nothing can be sent until it's back.

An agent's prompt shows on the Mac but not on the phone

Full phone control (approvals, questions, chat and diff review) works for Claude Code and Codex sessions started from Armada. OpenCode and plain terminals report their status and can be driven from the Term tab.

Remove a phone

Every paired phone is listed in Settings → iPhone on the Mac. Remove one and its access ends immediately, at home and through the relay.

My sessions survived quitting the app. Is that right?

Yes. A background process owns your terminals so updates and relaunches don't interrupt an agent mid-task. To stop everything, choose Armada → Stop All Sessions and Quit.