Dev

Start Surge locally using the dev shell function from ~/.zshrc.

Launch

You must run this as a background agent terminal. A foreground terminal blocks your turn and forces the user to manually background it. Do not wait for Phoenix to finish starting before backgrounding - launch in the background immediately, then verify in a separate command.

Run from the repo root:

cd "$(git rev-parse --show-toplevel)" && tail -f /dev/null | zsh -ic 'dev'

Shell tool settings:

• block_until_ms: 0 (background immediately - required)
• required_permissions: ["all"] (port binding, killing stale listeners, Livebook)

The tail -f /dev/null | pipe keeps stdin open so IEx stays alive in a background terminal. Do not run bare zsh -ic 'dev' without the pipe - agent shells close stdin immediately and IEx exits within seconds.