# Codex Reminders Bridge

让 Windows 上的 Codex 通过本地 MCP 工具管理当前用户自己的 iPhone/iCloud Reminders。

## 快速开始

1. 从 [GitHub 仓库](https://github.com/cis-aconiticacid/myplannar) 下载源码或 Release ZIP。
2. 按 [SETUP_GUIDE_ZH.md](SETUP_GUIDE_ZH.md) 准备 WSL、Codex 和 Apple App 专用密码。
3. 双击 `install.cmd`。
4. 重启 Codex，然后说：“列出我未完成的 iPhone 提醒事项。”

## 能做什么

- 同步并列出未完成或全部提醒；
- 创建带截止日期、备注和优先级的提醒；
- 修改、完成和删除提醒；
- 标题重名时使用 UID 消除歧义；
- 写操作前后同步，修改和删除前保留本地备份；
- 通过 MCP 工具描述和 [AGENTS.md](AGENTS.md) 约束 Codex 的操作流程。

## 隐私边界

仓库和发布 ZIP 不包含 Apple ID、密码、CalDAV URL、集合 UUID、提醒内容、同步缓存或个人数据库。首次安装后，凭据保存在当前 WSL 用户的：

```text
~/.local/share/codex-reminders-bridge/
```

密码文件权限设置为仅当前用户可读。应用永远不要求 Apple Account 主密码，只使用可单独撤销的 App 专用密码。

## 组件

```text
Codex
  -> iphone-reminders MCP (stdio)
  -> Reminders Bridge
  -> vdirsyncer + iCloud CalDAV
  -> iPhone Reminders
```

核心代码位于 `app/`；安装器把它复制到 WSL 私有目录并创建隔离虚拟环境。运行数据不写回仓库。

## 发布检查

创建新版本前请：

1. 运行测试和隐私扫描；
2. 更新 `VERSION`；
3. 将干净的发布 ZIP 附加到 GitHub Release。

本项目通过 iCloud 的 CalDAV 兼容层访问 VTODO。Apple 没有为此项目背书；接口行为变化可能需要更新适配。