Skip to content

About

A simple Swift CLI for iPhone Live Activities and Codex/Claude hooks.

Resources

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

Agent Alerts CLI

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

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 --version

To 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.

Connect

agentalerts setup

Approve the connection on your iPhone, then paste the one-time token into the hidden terminal prompt.

Send a Live Activity

agentalerts send "Build finished"
agentalerts send "Tests failed" --summary "Open the test report." --status critical

These 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 end

The final command closes the activity. Without --activity-id, sends share an ID for the current directory.

Custom layouts

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-health

Start 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.

Connect your agents

agentalerts hooks install

This 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 uninstall

Ordinary 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.

More options and configuration · Development and releases

About

A simple Swift CLI for iPhone Live Activities and Codex/Claude hooks.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages