Send Live Activities to your iPhone from the terminal. Get updates when Codex or Claude is working, finishes, or needs your attention.
Requires macOS 13+ and Agent Alerts on your iPhone.
Install the prebuilt Swift CLI with Homebrew:
brew tap andreasink/agent-alerts-cli https://github.com/AndreasInk/agent-alerts-cli.git
brew install andreasink/agent-alerts-cli/agentalerts
agentalerts --versionTo build from source instead, use Swift 6+:
git clone https://github.com/AndreasInk/agent-alerts-cli.git
cd agent-alerts-cli
swift build -c release --product agentalerts
install -d "$HOME/.local/bin"
install .build/release/agentalerts "$HOME/.local/bin/agentalerts"Add ~/.local/bin to your PATH if needed.
agentalerts setupApprove the connection on your iPhone, then paste the one-time token into the hidden terminal prompt.
agentalerts send "Build finished"
agentalerts send "Tests failed" --summary "Open the test report." --status criticalThese commands start or update a Live Activity and send a notification. Reuse an ID to follow one task:
agentalerts send "Building" --activity-id build --event start
agentalerts send "Running tests" --activity-id build
agentalerts send "Build finished" --activity-id build --event endThe final command closes the activity. Without --activity-id, sends share an ID for the current directory.
Use a JSON file to arrange text, metrics, charts, and progress indicators:
agentalerts send --file examples/progress.json --activity-id checks
agentalerts send --file examples/build-health.json --activity-id build-healthStart with the progress layout or build health layout. Edit the file and send it again with the same ID to update it. Each send replaces the content, so include the full layout.
Layouts use supported native components. See the layout guide for the JSON format and limits, or run agentalerts send --help for command options.
agentalerts hooks installThis detects Codex and Claude and adds automatic status updates. In Codex, open /hooks to review and trust them. Restart an existing agent session to load the changes.
Check or remove the integration:
agentalerts hooks status
agentalerts hooks uninstallOrdinary updates share the project name and agent status, without sending your conversations.
Phone approvals aren't available yet. See the usage guide for their current requirements and limitations.