cyclotomy0.3.2
A provenance-aware workspace checkpointer for Pi Coding Agent.
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
Cyclotomy
为 Pi Coding Agent 会话树保存工作区检查点。
Pi 的对话可以在历史中穿梭；工作区不能，它永远只有此刻。
Cyclotomy 让两者同行。它安静地记录对话推进时的工作区，并在你回到会话树中的另一个位置时，恢复那一刻的工作区。
安装，然后照常使用 Pi。
安装
需要 Node.js >=24.15.0、Pi Coding Agent >=0.84.0，以及 Git。
pi install npm:cyclotomy
Cyclotomy 默认在已保存的 Pi 会话中自动启动，不支持 --no-session 和内存会话。
pi update npm:cyclotomy
pi remove npm:cyclotomy
使用
| 命令 | 作用 |
|---|---|
/tree |
在 Pi 会话树中移动；恢复前会预览工作区变化。 |
/drift |
查看恢复当前检查点会改变什么。 |
/restore |
恢复当前节点的检查点。 |
/cyclotomy |
查看状态。 |
/cyclotomy pause / resume |
暂停或恢复当前实例。 |
/cyclotomy enable / disable |
设置后续实例是否自动启动。 |
恢复可能覆盖或删除文件，请在确认前检查预览；Escape 可以取消。你也可以保留当前文件，在对话的新分支上继续工作。
每个会话节点最多保存一个检查点。没有检查点的节点继承最近的已记录祖先；未完成的捕获不会覆盖已有检查点。
你的数据
- Git 工作区遵循 Git 忽略规则，
.git不会被记录或修改。非 Git 工作区会管理目录内支持的文件。 - 检查点保存在工作区之外，默认位于
~/.pi/agent/cyclotomy/。数据未加密，卸载后仍保留。 - Cyclotomy 保存实际观察到的工作区状态。请继续使用 Git 和独立备份。
日常使用无需配置。可选设置与恢复说明见配置与存储。