How to Run Aider AI Coding Agent on Mac from iPhone (Mobile Git Pair Programming)
If you use terminal-based AI coding agents, you are probably familiar with Aider. It is one of the most reliable open-source pair programming tools around. Instead of working in an isolated chat sidebar, Aider edits your real files directly in your repository and makes clean, formatted git commits automatically with sensible commit messages.
The catch with Aider is that complex tasks take time. When you ask it to refactor a messy API endpoint, write unit tests for five modules, or fix a tricky database migration, it might run for five or ten minutes reading files, generating diffs, and running your test suite.
You don't need to sit glued to your desk while that happens. Here is how to run Aider on your Mac and monitor, steer, and approve its work directly from your iPhone.
Why Aider Must Run on Your Mac, Not Your Phone
Some developers try to run Aider directly on their phone using mobile Linux emulators like iSH or a-Shell. That almost always turns into a frustrating experience:
- •Python Dependency Hell: Aider relies on tree-sitter, tokenizers, and binary wheels that often fail to compile on iOS sandboxes.
- •Missing Build Tools: Your phone does not have your Mac's node_modules, Docker daemon, PostgreSQL databases, or compilers to actually test the code.
The right architecture is simple: your Mac is the “unit of truth” where the code lives, compiles, and tests. Your iPhone is just the remote control that sends prompts and reviews git commits.
The Mobile Aider Workflow with Macky
With Macky, you connect your iPhone directly to your Mac's interactive zsh shell over an end-to-end encrypted WebRTC channel.
Recommended Daily Setup:
- On your Mac, open your project folder in Terminal:
cd ~/Projects/my-app. - Launch a multiplexer like tmux so your session survives if you step away:
tmux new -s aider-work. - Start Aider with your model of choice:
aider --model claude-3-5-sonnet(or your preferred local Ollama model). - Open Macky on your iPhone, enter your Master Password, and attach to the session.
Steering Aider from Your Phone Keyboard
Typing terminal commands on a phone touch keyboard is usually painful because standard mobile keyboards lack Control, Escape, and arrow keys.
Macky includes a persistent accessory keyboard row tailored for terminal navigation. Here is how to use it with Aider's built-in commands:
Type /add src/auth.ts to pull files into context, or /drop to remove them. Use the Tab key on the accessory bar for fast path auto-completion.
Type /diff to review the exact changes Aider generated. Full ANSI 256-color support makes green additions and red deletions immediately readable on an iPhone OLED display.
Type /test npm test. Aider will run your test suite directly on your Mac, read any failures, and auto-correct its own code until tests pass.
If Aider takes a wrong turn, type /undo to instantly revert the last git commit.
Mobile Voice Coding Trick
Typing complex prompts on a phone screen can be slow. A practical trick when using Aider from your iPhone is using iOS system dictation.
Tap the microphone icon on your iOS keyboard and speak your instructions naturally: “Refactor the authentication handler to return a 401 status when the token expires, and add tests for invalid payloads.” Aider parses natural language prompts well, making voice dictation a surprisingly efficient way to write code while away from your desk.
Summary
AI coding tools like Aider, Claude Code, and Codex don't require you to be chained to your chair. Running the agent on your Mac while steering it from your iPhone gives you the best of both worlds: full desktop computing power with mobile freedom.
Related Guides & Comparisons
Try Macky
Connect to your Mac terminal from your iPhone. Free to start, no configuration required.