为 SQLite 而生的版本控制。
Git 会把 SQLite 数据库作为不透明的二进制文件跟踪。Graft 提供存储高效的快照、 表结构合并与行级差异，同时保留普通 SQLite 工作区文件。
自定义差异工具可以把 data.sqlite 转换成可读内容，方便审查变化。Git 的存储和
合并仍停留在文件级，无法识别 SQLite 的存储、表结构和行。
Graft 补上这些数据库语义：
- 捕获一致快照，包括 WAL 中已经提交的内容
- 通过内容寻址的数据块复用不同版本中未变化的 SQLite 内容
- 提供表结构、表和行级差异与合并
- 提供类似 Git 的提交、分支、标签、恢复与远端同步
数据库的相关文件也可以记录在同一次提交中：
app-data/
data.sqlite
settings.json
attachments/
Graft 采用类似 Git 的工作流，并使用独立的仓库格式与远端机制。
Graft Playground 会在浏览器中运行 真实的 Graft CLI。无需安装即可体验提交、分支、行级差异与冲突处理。
在 macOS 或 Linux 安装最新版本：
curl -fsSL https://graft.eidos.space/install.sh | sh创建仓库并保存一个 SQLite 数据库：
mkdir graft-demo
cd graft-demo
graft init
graft sql --db data.sqlite \
"CREATE TABLE notes(id INTEGER PRIMARY KEY, body TEXT NOT NULL);"
graft sql --db data.sqlite \
"INSERT INTO notes(body) VALUES ('first note');"
graft add --all
graft commit -m "Save initial state"
graft log继续阅读 CLI 快速开始。
| 集成方式 | 适用场景 |
|---|---|
| CLI | 评估、脚本、智能体与一次性命令 |
| 结构化 JSON 输出 | 稳定的应用与自动化边界 |
| Node.js SDK | 长驻的进程内仓库会话 |
| 远程服务包 | 托管 Graft HTTP 远程协议 |
安装 Node.js SDK：
pnpm add @eidos.space/graftEidos Lite 是面向 .eidos
多维表格与普通文件的本地优先桌面应用。它使用 Graft：
- 将整个本地工作空间记录为一个版本
- 保存前展示文件变化与 SQLite 行级变化
- 查看和恢复旧版本，同时保留已有历史
- 通过可选的 Eidos Sync 同步工作空间历史
集成代码位于开源的 Eidos 仓库。
如果你的产品也在使用 Graft，欢迎提交 pull request 添加到这里。
- 应用照常写入普通 SQLite 数据库和文件。
graft add捕获一致快照并暂存相关路径。graft commit将它们记录为一个应用状态。- 差异、分支、合并、恢复与同步都基于这套历史运行。
仓库历史保存在普通工作树旁的 .graft/ 中。应用可以继续使用原有的
SQLite 库与文件 API。
Graft 目前仍是实验性项目。CLI、结构化输出、Node.js SDK 和远程协议 是受支持的集成界面；存储布局与内部 Rust 模块仍属于实现细节。
Graft 是 SQLite 事务的补充，不替代应用授权、实时复制或用于源码管理的 Git。
完整开发流程见 CONTRIBUTING.md。
cargo check --workspace --all-targets
just test
pnpm check:remote
pnpm test:remote与实现对齐的规范位于 docs/specs。
Graft 最初从 orbitinghail/graft 分叉而来。原实现中的事务型存储引擎现已成为本项目 SQLite 存储层的基础。 本仓库现已独立维护，不再保留 GitHub fork 关系。
你可以选择 Apache License 2.0 或 MIT License。