https://github.com/hatefrad/airprompt
Set up remote terminal access for AI agent workflows in minutes
https://github.com/hatefrad/airprompt
ai-agents llm-tools remote-access remote-control tailscale tmux
Last synced: about 2 months ago
JSON representation
Set up remote terminal access for AI agent workflows in minutes
- Host: GitHub
- URL: https://github.com/hatefrad/airprompt
- Owner: hatefrad
- License: mit
- Created: 2026-04-25T10:26:35.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-25T11:36:07.000Z (about 2 months ago)
- Last Synced: 2026-04-25T12:25:47.487Z (about 2 months ago)
- Topics: ai-agents, llm-tools, remote-access, remote-control, tailscale, tmux
- Language: TypeScript
- Homepage:
- Size: 39.1 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# airprompt
Set up remote terminal access for AI agent workflows in minutes.
Run this on your Mac and you'll be able to SSH into your terminal from your phone — so when Claude or another AI agent needs your input, you can respond from anywhere.
## Usage
```bash
npx airprompt
```
Preview the setup without installing or enabling anything:
```bash
npx airprompt --dry-run
```
Check your current setup without changing anything:
```bash
npx airprompt status
```
That's it. The CLI will:
1. Check you're on macOS
2. Install and connect Tailscale (if needed)
3. Install tmux (if needed)
4. Enable macOS SSH Remote Login (if needed)
5. Print your Tailscale IP and Termius setup instructions
## What airprompt changes
airprompt may install Tailscale and tmux with Homebrew, and it may run `sudo systemsetup -setremotelogin on` to enable macOS Remote Login.
That SSH change lets devices on your Tailscale network connect to your Mac with your normal macOS username and password or SSH key. It does not open a public tunnel by itself, but you should only use it with a Tailscale account and devices you trust.
To disable Remote Login later:
```bash
sudo systemsetup -setremotelogin off
```
## What you need on your phone
- [Tailscale](https://tailscale.com/download) — sign in with the same account
- [Termius](https://termius.com) — SSH client, add host with the IP printed by this CLI
## Keeping sessions alive with tmux
```bash
# Start a named session
tmux new -s work
# Detach (session keeps running)
Ctrl+B, D
# Reattach from your phone
tmux attach -t work
```
## SSH keys
For regular use, prefer SSH keys over passwords:
```bash
ssh-keygen -t ed25519 -C "airprompt"
ssh-copy-id @
```
If `ssh-copy-id` is not installed, append the public key from `~/.ssh/id_ed25519.pub` to `~/.ssh/authorized_keys` on your Mac.
## Requirements
- macOS
- [Homebrew](https://brew.sh) (for auto-installing Tailscale and tmux)
## Status checks
`npx airprompt status` checks whether Tailscale is installed and connected, tmux is installed, and macOS Remote Login is reachable. Status checks are read-only and do not require sudo.
## Security model
airprompt assumes SSH is reachable over your private Tailscale network, not the open internet. Keep your Tailscale account protected, remove old devices from your tailnet, and prefer SSH keys over passwords for regular use.
## Why
When an AI agent is running a long task and needs confirmation, you shouldn't have to be at your desk. This tool sets up the infrastructure so you can respond from your phone.