opencode-notify-ios

通过 Bark 将 OpenCode 事件推送通知到 iOS 设备。

前提

在 App Store 安装 Bark，获取设备密钥。

安装

全局安装

编辑 ~/.config/opencode/opencode.json：

{
  "plugin": ["@jachy/opencode-notify-ios"]
}

项目安装

在项目根目录创建或编辑 opencode.json：

{
  "plugin": ["@jachy/opencode-notify-ios"]
}

配置

在项目根目录创建 notify-ios.json，或者在全局目录 ~/.config/opencode/notify-ios.json 创建一份共用配置（项目优先于全局）：

{
  "deviceKey": "your_bark_device_key",
  "sound": "default",
  "enable": ["permission.updated", "session.error"],
  "templates": {
    "permission.asked": {
      "title": "OpenCode 需要确认",
      "body": "请确认操作"
    }
  }
}

| 字段 | 说明 | |------|------| | deviceKey | 必填。Bark 设备密钥 | | sound | 通知声音，默认 "default" | | enable | 启用的事件列表。默认 ["permission.asked", "session.error", "session.idle"]，设为 [] 关闭所有通知 | | templates | 按事件自定义文案，body 支持 \n 换行。支持变量 {{time}}（当前本地时间）和 {{session.title}}（会话标题） |

配置文件修改即时生效，无需重启。

模板变量

title 和 body 中可使用以下变量，运行时自动替换：

| 变量 | 说明 | 示例值 | |------|------|--------| | {{time}} | 当前本地时间 | 2026-06-14 15:30:00 | | {{session.title}} | 当前会话标题 | 修复登录 Bug | | {{project.name}} | 项目目录名 | opencode-push-ios |

示例：

{
  "templates": {
    "session.idle": {
      "title": "OpenCode 空闲",
      "body": "[{{time}}] 会话「{{session.title}}」进入空闲"
    }
  }
}

事件

| 推荐 | 事件 | 触发时机 | |:---:|------|------| | ✓ | permission.asked | OpenCode 需要用户确认 | | ✓ | session.error | 会话发生错误 | | | session.idle | 会话进入空闲 |

完整事件列表见 DEVELOPMENT.md。

安全

notify-ios.json 包含 Bark 设备密钥，强烈建议将其加入 .gitignore，避免密钥泄露：

# opencode-notify-ios
notify-ios.json