Recommended workflow

How to run AI coding agents on an always‑on Mac mini

This is the setup Shell Drop was designed for. Your agents run on one Mac at home or in the office, and you direct them from your iPhone, iPad or laptop, wherever you are.

Our recommended always‑on agent workflow

  1. One always‑on Mac runs every agent. A Mac mini is ideal. Any Mac or Linux machine that stays on works the same way.
  2. Each agent gets its own Herdr workspace or Tmux session. Claude Code, Codex, Grok Build, Hermes Agent, OpenClaw or any other terminal agent, one per project.
  3. Tailscale connects your devices to the Mac. Your phone reaches it from anywhere, with nothing opened to the internet.
  4. Shell Drop is your front end. Open a tab, see where each agent is up to, and send the next instruction by keyboard, voice or screenshot.

The agents keep working on the Mac when you put your phone away. Pick up any device and carry on from where they are.

Why an always‑on Mac mini

A coding agent on a long task can work for hours. On a laptop that work stops when the lid closes. A Mac mini is small, quiet and cheap to leave running, so the agents have somewhere to live that never sleeps.

Everything happens on that one machine: the code, the agents and their history. Your phone, iPad and laptop all open the same live sessions, so there is nothing to sync and no question of which device you started on.

Two Mac settings make it a proper always‑on host. Turn on Remote Login so you can SSH in, and stop the Mac from sleeping:

sudo systemsetup -setremotelogin on
sudo pmset -a sleep 0

Install your agents

Any agent that runs in a terminal works in this setup. Install the ones you use on the Mac, then start each one inside its own Herdr workspace or Tmux session (next section).

Claude Code

Anthropic's command line agent. Use the terminal version on the Mac; Claude Code in the terminal vs the desktop app explains why.

curl -fsSL https://claude.ai/install.sh | bash
claude --dangerously-skip-permissions

More: Claude Code on iPhone

Codex

OpenAI's Codex CLI. The bypass flag is its full‑auto mode, often called yolo mode.

npm install -g @openai/codex
codex --dangerously-bypass-approvals-and-sandbox

More: Codex on iPhone

Grok Build

xAI's coding agent, for SuperGrok and X Premium Plus subscribers. The first run opens a browser to sign in, so do that once at the Mac or over screen sharing. If which grok points somewhere unexpected, a different package named grok is installed too.

curl -fsSL https://x.ai/cli/install.sh | bash
grok --always-approve

Hermes Agent

The open source agent from Nous Research. The installer sets up its own Python, so it leaves the system one alone.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes --tui

OpenClaw

OpenClaw runs a gateway in the background as a macOS LaunchAgent, so it keeps going without Herdr or Tmux. Keep a workspace or session open for its command line, and check on it from Shell Drop with openclaw status or openclaw doctor. It needs Node 22 or later.

npm install -g openclaw@latest
openclaw onboard --install-daemon

About the skip‑permissions flags

Each start command above runs the agent without stopping to ask before every edit or command. On an always‑on Mac that matters, because nobody is at the desk to approve. It also gives the agent real reach on that machine, so start it on low‑stakes work and widen what you hand over as you learn how it behaves. Leave the flag off any agent you would rather supervise.

Herdr or Tmux: one agent per workspace or session

Herdr and Tmux keep each agent running on the Mac after you disconnect. Close Shell Drop, lose signal or put the phone in a drawer, and the agent carries on. Reconnect and it is still there with its full scrollback.

We recommend Herdr, a free, open source workspace manager built for AI agents. It marks every agent as working, blocked or idle, and Shell Drop reads that to tell you which one needs you. Tmux is fully supported too, and both can run side by side on the same Mac.

Herdr, recommended

One agent per Herdr workspace

brew install herdr
herdr
herdr workspace create --cwd ~/projects/web-app --label web-app
herdr workspace create --cwd ~/projects/scraper --label scraper

Start one agent in each workspace, give it its task, and detach with Ctrl-b then q. There is nothing to configure for Shell Drop: each tab takes its workspace name by itself.

Tmux

One agent per Tmux session

brew install tmux
tmux new -s claude-api
# start the agent, then detach with Ctrl-b d

Add two lines to ~/.tmux.conf so each Shell Drop tab is named after its session:

set -g set-titles on
set -g set-titles-string '#S'

Reach the Mac from anywhere with Tailscale

On your home Wi‑Fi, Shell Drop can reach the Mac by its local address. Everywhere else, use Tailscale. It joins your Mac, iPhone, iPad and laptop into one private network, so the Mac keeps the same address from a train, a cafĂ© or another country. Nothing is opened to the internet and there is no port forwarding on your router. The personal plan is free.

  1. Install Tailscale on the Mac from tailscale.com/download and sign in.
  2. Install Tailscale on your iPhone and iPad from the App Store and sign in with the same account.
  3. Find the Mac's Tailscale address, which starts with 100, in the Tailscale app on any of your devices.
  4. In Shell Drop, add a connection with that address and your Mac user name.

Tailscale carries the connection and the Mac's own SSH server answers it, the one Remote Login turned on. You do not need Tailscale SSH for this setup. If a phone ever stops connecting while the Mac looks fine, turn Tailscale off and on again on the phone.

What Shell Drop does in this setup

Shell Drop is a free terminal for iPhone, iPad and iPhone Duo, built as the front end to agents on an always‑on machine. Its purpose is portability: getting the work done from any location, on any device you have with you.

  • Tabs that know your agents. Each tab takes its Herdr workspace or Tmux session name, and after a dropped connection or a relaunch it goes straight back into the same session.
  • Agent needs you. When an agent stops for an answer, your Lock Screen says so. Settings > Agents > Live activities
  • Agent Comms. Every agent on every machine on one screen, each marked Working, Needs Human, Quick block or Finished. Coming soon
  • Voice Drop. Speak a long brief, read it back, then send it.
  • Screenshots and files. Paste an image or attach a file and Shell Drop uploads it to the Mac and puts its path at the prompt.
  • Text back to the phone. An agent can copy text straight to your phone's clipboard, ready to paste into Mail or Messages.
  • Git pushes with the keys on your phone. Forward your SSH keys to the Mac for one connection, and approve each first use with Face ID. The private keys never leave the phone.
  • Connections that stay up. Keep sessions alive in the background while you switch apps.

Optional: the one‑key login menu

Shell Drop already takes you straight into each agent's tab. If you also SSH in from a desktop, this ~/.zshrc block lists every Herdr workspace and Tmux session on login, each on its own key: press q and Enter to jump into the first.

Show the login menu code
# ~/.zshrc on the agent box: one-key menu of Herdr workspaces and tmux sessions
_session_picker() {
    local -a rows f sa
    local line s id lb i pick
    # Herdr: one row per workspace in every running Herdr session (reads JSON with jq)
    if command -v herdr &>/dev/null && command -v jq &>/dev/null; then
        for line in ${(@f)"$(herdr session list --json 2>/dev/null | jq -r '.sessions[]? | select(.running)
                | [.name, (if .default then 1 else 0 end)] | @tsv')"}; do
            f=("${(@ps:\t:)line}"); [[ -n ${f[1]} ]] || continue
            sa=(); [[ ${f[2]} == 1 ]] || sa=(--session "${f[1]}")
            for id lb in ${(@f)"$(herdr $sa workspace list 2>/dev/null | jq -r '.result.workspaces[]? | .workspace_id, .label')"}; do
                [[ -n $id ]] && rows+=("h"$'\t'"$lb"$'\t'"${f[1]}"$'\t'"$id"$'\t'"${f[2]}")
            done
        done
    fi
    # tmux: one row per session
    if command -v tmux &>/dev/null; then
        for s in ${(@f)"$(tmux ls -F '#S' 2>/dev/null)"}; do
            [[ -n $s ]] && rows+=("t"$'\t'"$s")
        done
    fi
    (( $#rows )) || { echo "no agents running"; return }
    local keys=(q w e r t y u i o p a s d f g h j k l z x c v b n m) c1="" c0=""
    [[ -t 1 ]] && { c1=$'\e[38;5;73m'; c0=$'\e[0m'; }   # Herdr rows in teal
    printf "\nWelcome operator.\n\n"
    for (( i = 1; i <= $#rows && i <= $#keys; i++ )); do
        f=("${(@ps:\t:)rows[i]}")
        if [[ ${f[1]} == h ]]; then printf "  %s) %s%s%s\n" ${keys[i]} "$c1" "${f[2]}" "$c0"
        else printf "  %s) %s\n" ${keys[i]} "${f[2]}"; fi
    done
    echo; echo -n "> "; read pick
    [[ -z $pick ]] && return
    pick=${pick:l}
    local idx=${keys[(i)$pick]} target=$pick
    if (( idx <= $#rows )); then
        f=("${(@ps:\t:)rows[idx]}")
        if [[ ${f[1]} == h ]]; then
            sa=(); [[ ${f[5]} == 1 ]] || sa=(--session "${f[3]}")
            if [[ -n $HERDR_ENV ]]; then herdr $sa workspace focus "${f[4]}" >/dev/null; return; fi
            # focus the workspace once this terminal has attached
            { sleep 0.5; herdr $sa workspace focus "${f[4]}"; sleep 1; herdr $sa workspace focus "${f[4]}"; } &>/dev/null </dev/null &!
            if [[ ${f[5]} == 1 ]]; then herdr; else herdr session attach "${f[3]}"; fi
            return
        fi
        target=${f[2]}
    fi
    if [[ -n $TMUX ]]; then tmux switch-client -t "$target"; else tmux attach -t "$target"; fi
}
alias go='_session_picker'

# Show the menu on login (skip inside tmux and inside Herdr)
if [[ -z $TMUX && -z $HERDR_ENV ]]; then
    _session_picker
fi

This is zsh, the default macOS shell, so keep it in ~/.zshrc. Herdr's lists are read with jq (brew install jq). Type go any time to show the menu again.

Questions

Do I need a Mac mini?

No. Any Mac or Linux machine that stays on works the same way, including an old laptop with the lid open or a cloud server. A Mac mini is a common choice because it is small, quiet and uses little power.

Can I run Claude Code, Codex, Grok Build, Hermes Agent and OpenClaw on the same Mac?

Yes. Give each agent its own Herdr workspace or Tmux session. How many run at once depends on the Mac's memory and on each agent's plan limits.

Do the agents keep running when I close Shell Drop?

Yes. Herdr or Tmux keeps every agent running on the Mac. Open Shell Drop again and each tab goes back into its session where the agent left off.

Do I need Tailscale?

Not on the same Wi-Fi as the Mac. Away from home, Tailscale is the simplest way to reach the Mac without opening a port on your router, and its personal plan is free.

Herdr or Tmux?

Both work with Shell Drop. Herdr marks each agent as working, blocked or idle, which Shell Drop uses to tell you which agent needs you. Tmux is the long-standing standard and is fully supported.

Does Shell Drop cost anything?

No. Shell Drop is free on the App Store for iPhone, iPad and iPhone Duo, with no subscription or account.

Shell Drop is free on the App Store for iPhone, iPad and iPhone Duo, with no subscription or account.

Download on the App Store