Repository navigation
Releases
v0.1.9-rc.2
Install yappr 0.1.9-rc.2
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/fractalops/yappr/releases/download/v0.1.9-rc.2/yappr-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/fractalops/yappr/releases/download/v0.1.9-rc.2/yappr-installer.ps1 | iex"Download yappr 0.1.9-rc.2
| File | Platform | Checksum |
|---|---|---|
| yappr-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| yappr-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| yappr-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| yappr-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| yappr-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo fractalops/yapprYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>v0.1.9-rc.1
The release workflow failed before it built the binaries. The installers and archives are unavailable for this tag.
This is a prerelease.
The yappr plugin for Claude Code and Codex teaches the agent to use yappr post, yappr ask, and yappr approve.
The experimental yappr-hooks plugin sends permission requests to your other device and shows when the agent finishes. By default, the hooks act only while you are away. If you come back while a request is open, Yappr cancels it and the agent can ask in the terminal. See the agent hooks reference.
To try the plugins in this prerelease, add the marketplace at this tag. Then follow the plugin install commands in the README.
claude plugin marketplace add 'fractalops/yappr#v0.1.9-rc.1'
codex plugin marketplace add fractalops/yappr --ref v0.1.9-rc.1Yappr 0.1.9 removes yappr hooks install, yappr hooks status, and yappr hooks remove. If you used Yappr 0.1.8 to install hooks, remove them before you install yappr-hooks. Delete only the entries whose command contains hook --agent.
| Scope | Claude Code | Codex |
|---|---|---|
| User | ~/.claude/settings.json |
~/.codex/hooks.json |
| Project | .claude/settings.json |
.codex/hooks.json |
| Local | .claude/settings.local.json |
If you set CLAUDE_CONFIG_DIR or CODEX_HOME, look there for the user settings file. If you leave the old hooks in place, one permission request can reach your device twice.
v0.1.8
What's changed
- Get questions, approvals, warnings, and alerts as notifications when the yappr.run page is closed. In the page settings, turn on Notify me when this page is closed. The computer sends the notification with Web Push. No yappr server is in the path.
- Answer from the notification. Chrome on Android and on the desktop shows the choices as buttons, also on a locked screen. On iPhone, a tap opens the question in the app.
- Use
yappr approve --unlockfor an approval that needs an unlocked device. The notification then shows only Reject. To approve, open the question. - Set the name that devices show for this computer with
yappr config --name "Work Mac".yappr configalso saves the relay and local discovery settings. It replacesyappr network. yappr statusshows the running writer: its process ID, version, and path.yappr pairwaits foryappr pair --acceptwhen the terminal input ends. It does not reject the device.
Known limits:
- On Android, a reply from the notification can stay in the outbox until yappr opens again.
- On iPhone, notifications do not show buttons. Open the question to answer.
Install yappr 0.1.8
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/fractalops/yappr/releases/download/v0.1.8/yappr-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/fractalops/yappr/releases/download/v0.1.8/yappr-installer.ps1 | iex"Download yappr 0.1.8
| File | Platform | Checksum |
|---|---|---|
| yappr-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| yappr-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| yappr-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| yappr-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| yappr-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo fractalops/yapprYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>v0.1.8-rc.4
Use yappr config to show or save the writer name, relays, and local network discovery for a feed.
With yappr approve --unlock, select the notification to open the question and approve in Yappr. On browsers with notification buttons, Reject stays available in the notification.
This is a prerelease.
Install yappr 0.1.8-rc.4
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/fractalops/yappr/releases/download/v0.1.8-rc.4/yappr-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/fractalops/yappr/releases/download/v0.1.8-rc.4/yappr-installer.ps1 | iex"Download yappr 0.1.8-rc.4
| File | Platform | Checksum |
|---|---|---|
| yappr-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| yappr-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| yappr-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| yappr-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| yappr-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo fractalops/yapprYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>v0.1.8-rc.3
Set a writer name with yappr push --name "Work Mac". New entries and notifications show the writer name and source.
Questions and approvals use Declarative Web Push on browsers that support it. A notification opens the exact question. Chrome still shows reply buttons.
This is a prerelease. Use the release candidate to change device records on feeds that use push.
Install yappr 0.1.8-rc.3
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/fractalops/yappr/releases/download/v0.1.8-rc.3/yappr-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/fractalops/yappr/releases/download/v0.1.8-rc.3/yappr-installer.ps1 | iex"Download yappr 0.1.8-rc.3
| File | Platform | Checksum |
|---|---|---|
| yappr-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| yappr-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| yappr-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| yappr-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| yappr-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo fractalops/yapprYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>v0.1.8-rc.2
This release candidate adds choices and question links to Web Push. The writer replaces a question's notification when the question closes. A compatible browser can send an answer from the notification.
- Use
yappr approve --unlockto open the app when someone selects Approve. Reject can still send an answer from the notification. - Use
yappr push --preview titleto hide the sender, body, and choices. yappr statusshows the writer's process ID, version, and binary path.- Pairing waits for a manual decision when terminal input ends.
yappr postcan return 5 after a push arrives. This code means the device did not confirm that it saved the entry.
Do not run 0.1.7 on a feed that uses push. It can remove push settings when it changes a device record. This release keeps unknown fields in device records.
Install yappr 0.1.8-rc.2
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/fractalops/yappr/releases/download/v0.1.8-rc.2/yappr-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/fractalops/yappr/releases/download/v0.1.8-rc.2/yappr-installer.ps1 | iex"Download yappr 0.1.8-rc.2
| File | Platform | Checksum |
|---|---|---|
| yappr-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| yappr-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| yappr-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| yappr-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| yappr-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo fractalops/yapprYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>v0.1.8-rc.1
This release candidate adds Web Push for paired browsers. The writer sends a notification for a question, warning or alert when the browser does not confirm the entry. The notification setting requires the matching browser update.
Install yappr 0.1.8-rc.1
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/fractalops/yappr/releases/download/v0.1.8-rc.1/yappr-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/fractalops/yappr/releases/download/v0.1.8-rc.1/yappr-installer.ps1 | iex"Download yappr 0.1.8-rc.1
| File | Platform | Checksum |
|---|---|---|
| yappr-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| yappr-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| yappr-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| yappr-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| yappr-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo fractalops/yapprYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>v0.1.7
What's changed
- Compare a six-digit check code on both devices before accepting a pairing request.
- Show the check code next to the decision in
yappr startandyappr pair. - Close the terminal prompt when the invitation expires.
- Finish an interrupted acceptance. Let a waiting CLI device get the result after the writer restarts.
On the computer that serves the feed, create a pairing invitation.
yappr start --pairScan the QR code in the Yappr app and request pairing. Compare the check codes on the two devices. If they match, enter y on the computer. If they differ, enter n.
Install yappr 0.1.7
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/fractalops/yappr/releases/download/v0.1.7/yappr-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/fractalops/yappr/releases/download/v0.1.7/yappr-installer.ps1 | iex"Download yappr 0.1.7
| File | Platform | Checksum |
|---|---|---|
| yappr-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| yappr-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| yappr-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| yappr-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| yappr-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo fractalops/yapprYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>v0.1.7-rc.1
Install yappr 0.1.7-rc.1
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/fractalops/yappr/releases/download/v0.1.7-rc.1/yappr-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/fractalops/yappr/releases/download/v0.1.7-rc.1/yappr-installer.ps1 | iex"Download yappr 0.1.7-rc.1
| File | Platform | Checksum |
|---|---|---|
| yappr-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| yappr-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| yappr-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| yappr-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| yappr-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo fractalops/yapprYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>v0.1.6
What's changed
- Filter tool hooks by command with
event:matcher:command-pattern. - Receive tool results from Claude Code and Codex with
PostToolUse. Receive Claude Code tool errors withPostToolUseFailure. - Fix approval replies that could keep the answering command open.
- Preserve hook matchers and reject conflicting selections before changing agent settings.
- Improve QR sizing across terminals and clarify the hook examples and reference.
- Use a supported macOS runner for Apple Silicon release builds.
Ask before a push and receive test results:
yappr hooks install claude \
--events 'permission,stop,pretooluse:Bash:git push*,posttooluse:Bash:cargo test*'Known limitation: hook events above 1 MiB can fail decoding and produce no question or update.
Install yappr 0.1.6
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/fractalops/yappr/releases/download/v0.1.6/yappr-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/fractalops/yappr/releases/download/v0.1.6/yappr-installer.ps1 | iex"Download yappr 0.1.6
| File | Platform | Checksum |
|---|---|---|
| yappr-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| yappr-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| yappr-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| yappr-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| yappr-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo fractalops/yapprYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>