Check on your AI coding agent remotely
See every coding agent's status from your phone, get a push when one is Blocked or Done, and answer it, without going back to your desk.
Updated
Short answer
Install Waycar's host tools on the machine where your coding agents run, then pair your iPhone. The Console lists every agent by status. You get a push when one is Blocked or Done, and you can answer from the phone. The machine must be on and awake.
What you need
- An iPhone or iPad on iOS or iPadOS 18 or later.
- A Mac or Linux machine that is on, awake and reachable over SSH. On a Mac, turn on Remote Login.
- Your coding agents running in tmux 3.2 or later, or in herdr 0.7.5 or later. herdr also needs AllowTcpForwarding set to local or yes.
- `curl` and `tar` on that machine, for the install command that sets up the Waycar host tools. No Node needed.
- Notifications allowed for Waycar in iOS, and turned on for the machine in the app, to get a push when an agent needs you.
What “remotely” means here
Your coding agents run on a Mac or Linux machine, in tmux or herdr, not in the Waycar app, and Waycar keeps no copy. Waycar reaches the machine, so you can start agents, look at them, hear from them and answer them while you are somewhere else.
Your phone connects straight to the machine over mosh, with SSH as the fallback. There is no Waycar account. Waycar has an optional push relay. Your machine encrypts each notification first, so the relay cannot read what it says. For Live Activities it does see how many agents are in each status.
See every agent at a glance
The Console lists agents from all your machines by status: Blocked, then Done, Working, Idle. Agents you pin stay above that order. Filter by machine, search by folder or title, or long-press to pin an agent. Open one to see its real terminal, exactly as it draws it.
Hear about it when it matters
- Push alerts. You get a notification when an agent is Blocked or Done, even with Waycar closed. The title names the workspace and the agent, such as “my-app · Claude”. The body says Blocked or Done. If you turn on AI Summaries, it adds a one-line summary. For a Chat Mode agent on herdr, a Done notification shows the agent’s reply.
- A short wait. Your machine holds a change for about 5 seconds, then checks again. If the agent has already moved on, nothing is sent. The same status is not repeated until the agent has been in another one.
- A badge. The Waycar icon counts the agents that need you, across all your machines.
- Lock Screen. A Live Activity can keep a machine on your Lock Screen and in the Dynamic Island.
Answer it from the phone
- Chat Mode. Start Claude Code, Codex, omp, pi or opencode in Waycar with Chat Mode on, and it opens as a chat. When one asks for permission, tap Allow or Cancel.
- The terminal. For any other agent, or one that was already running, open the real terminal and type with the toolbar keys, or write a prompt in the Composer and send it once.
- Files and photos. Attach up to 10 per message. Files can be up to 64 MiB each. Photos are resized to fit 16 MiB. Dictation runs on your phone on iOS 26 or later.
What Waycar cannot do
- It cannot run agents when your machine is off or asleep. Keep it on and awake.
- It needs tmux or herdr on the machine. On tmux, status comes from small hooks that the install command adds. Waycar shows status from them for Claude Code, Codex, omp, pi and opencode. Other agents show Unknown on tmux.
- It is an iPhone and iPad app with no native desktop or web client. An Android app is coming soon.
- The terminal session ends about 20 seconds after you leave the app and re-attaches on its own when you return. The agent keeps running.
Set it up
Run this on the machine, then scan the pairing QR code in Waycar:
curl -fsSL https://waycar.dev/install.sh | shOther ways to check on an agent
Some tools run the agent in a server, daemon or desktop app that you set up, and show it on your phone. Some SSH clients, such as Secure ShellFish, add alerts for agents you run in a terminal. Others are built into one agent. They fit different setups. See how Claude Code Remote Control, Happy and T3 Code differ from Waycar, with sources, or see all comparisons. If your agent is Claude Code, see run Claude Code from your iPhone.
Questions people ask
How do I know when my coding agent is done or stuck?
Waycar sends a push when an agent is Blocked and waiting for you, or Done. Your machine holds each change for about 5 seconds first, so a quick flip does not buzz your phone. A Live Activity can also keep a machine on your Lock Screen.
Can I check agents on more than one machine?
Yes. The Console lists agents from all your machines, sorted by status, with Blocked first after any you pinned. You can filter by machine, search by folder or title, and pin the ones you care about.
Does Waycar see my code or terminal output?
Not on Waycar's servers. Your SSH credentials and terminal data never touch them. Your phone connects straight to your machine over mosh or SSH. Your machine encrypts notifications first, so Waycar's push relay cannot read what they say. For Live Activities it does see how many agents are in each status. AI Summaries are off until you turn them on. Then your machine sends up to the last 60 lines of an agent's screen to an AI provider you already use, such as Anthropic, OpenAI or OpenRouter. That text does not pass through Waycar.
What if my machine is not reachable from the internet?
Put an SSH Jump Host in front of it, such as a small server that can reach your machine. Waycar checks host keys at both hops. mosh's UDP does not go through a Jump Host. Waycar sends it straight to your machine's address, so if your phone cannot reach that over UDP, the session runs over SSH.
Does it work if my computer is off?
No. The agents run on your own machine and Waycar keeps no cloud copy. The machine has to be on, awake and reachable. If you need agents that run with your computer off, Waycar is not the right tool.
Try Waycar on your own machine
Waycar is free for up to 10 Launches in any rolling 30 days. Waycar Pro removes the limit. See pricing for what counts as a Launch.