Give your scripts and agents a way to reach you and get an answer.
Yappr brings updates, questions, and approval requests from your machines to other devices. A script can wait for your reply before it continues. Each machine keeps its feed, so devices that were offline can catch up when they reconnect.
Your devices connect directly where possible. Otherwise, an iroh relay carries their end-to-end encrypted traffic. The relay cannot read your entries or answers, and it does not store your feed. You do not need an account.
On macOS or Linux:
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/fractalops/yappr/releases/latest/download/yappr-installer.sh | shOn Windows, in PowerShell:
powershell -ExecutionPolicy Bypass -c "irm https://github.com/fractalops/yappr/releases/latest/download/yappr-installer.ps1 | iex"The installer puts yappr in ~/.cargo/bin. To update, run it again.
The releases page also has the archives for each platform.
To build from source, use cargo install --git https://github.com/fractalops/yappr --tag v0.1.8.
On your computer, start Yappr and leave this terminal open:
yappr startThe first start shows a QR code and a YAPPR: code. They expire after five minutes.
On your phone:
- Open yappr.run and select Setup.
- Scan the QR code. You can also import a QR image or paste the
YAPPR:code. - Set Your device name to
phone, then select Request pairing. - Compare the check code on your phone with the check code in the computer's terminal.
If the codes match, enter y in that terminal. If they differ, enter n.
The computer prints the saved alias. Use that alias in the examples below.
In a second terminal on the same computer, send your first update:
echo "Backup complete" | yappr post --source backupThe command prints an entry number. On your phone, select Feed to see Backup complete.
To receive notifications when Yappr is closed, open Setup in the app.
In Advanced settings, select Notify me when this page is closed.
Allow browser notifications. Yappr sends notifications for questions, warnings, and alerts.
Run yappr config --name "Laptop" to set the writer name for new entries and notifications.
To use a CLI on another computer, see Connect another CLI.
Run these commands on the computer you paired with your phone.
df -h / | yappr post --source disk --title "Disk usage"post saves the command's output as one entry.
if yappr approve phone "Deploy to production?" --body "Commit abc123"
then
./deploy abc123
fiSelect Approve or Reject on your phone. The script runs deploy only
after approval.
choice=$(yappr ask phone "Backup failed. What next?" \
--choice retry="Retry backup" --choice stop) || exit $?
case "$choice" in
retry) ./backup ;;
stop) exit 1 ;;
esacask prints the selected value, such as retry. The script stops if the
question expires, you cancel it, or an error occurs.
The yappr plugin teaches Claude Code and Codex to use yappr post, yappr ask, and yappr approve.
# Claude Code
claude plugin marketplace add fractalops/yappr
claude plugin install yappr@yappr
# Codex
codex plugin marketplace add fractalops/yappr
codex plugin add yappr@yapprExperimental: agent hooks let you approve or reject the agent's permission requests from your other device, and show when it finishes. They act only while you are away from the computer.
# Claude Code
claude plugin install yappr-hooks@yappr
# Codex, then trust the hooks in /hooks
codex plugin add yappr-hooks@yapprThe CLI reference covers command options, exit codes, reading from several machines, device access, and connection settings.
MIT OR Apache-2.0
