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

  1. Install the app and allow notifications when prompted.
  2. Open Settings → Auto-installed to see your device key.
  3. Tap Send test push to confirm delivery works.
  4. 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 一张卡片,并呈现在主屏、锁屏和 灵动岛上。

快速开始

  1. 安装应用,在提示时允许通知。
  2. 打开 Settings → Auto-installed 查看你的 device key。
  3. 点 Send test push 确认推送链路通畅。
  4. 可选:在电脑上运行该页展示的安装脚本,自动配好 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。