Deploying an AI agent is the easy part. The real skill is managing agents running across multiple servers while you're away from your desk. Here's the practical playbook.
Session Persistence with tmux
The #1 rule: never run a long-lived agent in a bare SSH session. Use tmux:
tmux new -s agent-task
Start your agent inside tmux. If your SSH connection drops — phone goes to sleep, train enters a tunnel — the agent keeps running. Reconnect later and reattach:
tmux attach -t agent-task
This works from any device. Start the agent from your laptop, check progress from your phone via Onepilot.
Monitoring Progress
AI agents produce a lot of output. Here's how to stay on top of it:
- Scroll back — Onepilot's terminal supports full scroll history. Swipe up to review what the agent did while you were away.
- Git diff — After the agent finishes, run
git diffto see exactly what changed. This is the fastest way to audit the work. - Test suites — If your project has tests, run them. A passing suite is the best signal that the agent did its job.
Multi-Agent Workflows
Running agents across multiple servers? Keep it organized:
- One tmux session per task — name them descriptively:
tmux new -s fix-auth,tmux new -s migrate-db - One project per agent — don't let two agents edit the same codebase simultaneously
- Use branches — each agent works on its own git branch. Review and merge when satisfied.
Error Handling
Agents can get stuck. Common scenarios and fixes:
- Agent loops on a failing test — intervene via the terminal. Type a clarification or redirect its approach.
- Agent runs out of context — restart with a more focused task description.
- Permission errors — the agent inherits your SSH user's permissions. Check file ownership and sudo access.
Security Considerations
An AI agent has the same access as your SSH session. This means:
- It can read all files your user can read
- It can execute any command your user can run
- It can access any API key in the environment
Use least-privilege principles. Run agents as a dedicated user with limited permissions when possible. Read our full mobile AI agent security guide for details.
The iPhone Advantage
Your phone is the ideal management interface. You don't need the full power of a laptop to check a git diff, approve a PR, or restart a stuck agent. Onepilot gives you terminal access to all your servers from one app — check on agents between meetings, on the bus, or from bed.
New to deploying agents? Start with our step-by-step deployment guide. Want to manage agents via Telegram? Check out OpenClaw.