BarkAgent Support
BarkAgent shows you, at a glance, which of your AI coding agents needs your
attention. Your scripts and agents POST their status to your device key; the app
aggregates those pushes into per-agent cards and surfaces them on the Home Screen,
Lock Screen, and as a Live Activity.
Getting started
- Install the app and allow notifications when prompted.
- Open Settings → Auto-installed to see your device key.
- Tap Send test push to confirm delivery works.
- Optionally run the install script shown on that screen to wire up
Claude Code / Codex / OpenCode hooks on your computer.
Troubleshooting
- No pushes arrive
- Check that notifications are allowed for BarkAgent in iOS Settings →
Notifications. Then open Settings → Manage servers and pull to
refresh; the server dot should turn green.
- The status badge says "Missing"
- The device has not received an APNs token yet. Force-quit and reopen the app
while online; registration is retried on foreground.
- Agents show as "stale"
- A running agent that has not reported for longer than the stale timeout is
demoted automatically. Adjust the window in
Settings → Stale timeout.
- Widget or Lock Screen is out of date
- Widget refreshes are requested on every push but the system merges them under
its own budget. Opening the app always reconciles immediately.
- I want to use my own server
- BarkAgent speaks the Bark protocol. Add any Bark-compatible server in
Settings → Manage servers, then remove the default one.
The relay is open source and self-hostable.
Sending a push by hand
curl -X POST "https://barkagent.we2.xyz/<your-key>" \
-d "title=Build finished" \
-d "body=All tests green" \
-d "agent_id=ci" \
-d "agent_status=done" \
-d "progress=3/3"
Privacy
No analytics, no tracking, no third-party SDKs. See the
privacy policy.
Contact
Please open an issue at https://github.com/rtxIII/BarkMate/issues.
Source code: https://github.com/rtxIII/BarkMate.
BarkAgent 技术支持
BarkAgent 让你一眼看清哪个 AI agent 在等你插手。你的脚本和 agent 把状态 POST 到
你的 device key,应用把这些推送聚合成每个 agent 一张卡片,并呈现在主屏、锁屏和
灵动岛上。
快速开始
- 安装应用,在提示时允许通知。
- 打开 Settings → Auto-installed 查看你的 device key。
- 点 Send test push 确认推送链路通畅。
- 可选:在电脑上运行该页展示的安装脚本,自动配好
Claude Code / Codex / OpenCode 的 hook。
常见问题
- 收不到推送
- 先在 iOS 设置 → 通知里确认 BarkAgent 的通知权限已开启。再进
Settings → Manage servers 下拉刷新,服务器状态点应变绿。
- 状态显示 "Missing"
- 设备尚未拿到 APNs token。联网状态下强制退出再打开应用,前台会重试注册。
- Agent 变成 "stale"
- running 状态的 agent 超过陈旧阈值没有上报会被自动降级。阈值可在
Settings → Stale timeout 调整。
- Widget 或锁屏没有及时更新
- 每条推送都会请求刷新 widget,但系统会按自己的预算合并刷新时机。
打开应用总能立即追平。
- 想用自己的服务器
- BarkAgent 使用 Bark 协议。在 Settings → Manage servers
添加任意 Bark 兼容服务器后,即可删除默认服务器。中继服务端开源,可自部署。
隐私
无分析、无追踪、无第三方 SDK。详见隐私政策。
联系方式
请到 https://github.com/rtxIII/BarkMate/issues 提 issue。
源代码:https://github.com/rtxIII/BarkMate。