文件、Drive 与 git

每个账户、项目和组织都有一个 Drive——带有真实字节、有版本控制、可共享的文件。你可以通过 API 读写它们（GET/PUT /drive/:id/content），也可以把整个 Drive 通过 WebDAV 挂载，使用普通的文件工具、rclone，或你的编辑器。

# Mount your Drive as a real filesystem (macOS example).
mkdir -p ~/cagi && mount_webdav https://api.commandagi.com/dav ~/cagi
ls ~/cagi                     # your files, an agent's outputs, embodiment streams
cat ~/cagi/.commandagi/computers/<id>/screen.latest.jpg

Drive 通过 smart-HTTP 托管一个第一方 git 服务器——用普通的 git 客户端克隆、拉取、推送真实的仓库。智能体工作所在的机器会获得一个真实的工作树，一次提交可以运行在 .commandagi/ci.yml 中定义的 CI——轻量检查以无服务器方式运行，更重的原生构建则会溢出到一台真实的机器上。

# Push to a first-party git repo hosted on your Drive.
git remote add cagi https://api.commandagi.com/git/<owner>/<repo>.git
git push cagi main
# A commit can run CI defined in .commandagi/ci.yml.

环境变量和密钥以文件形式存放在 Drive 的根目录——一个明文的 .env 和一个加密的 .env.enc——通过组织 → 用户 → 项目 → 仓库的级联方式解析。智能体通过名称引用一个密钥，形式是 ${env:KEY}，它看到的永远只是占位符；真实值会在边界处注入。根目录下的一个 .profile 会为该作用域内的一切配置好 shell 环境。

同一个文件系统会把正在运行的系统投射出来：你已连接的设备及其实时数据流、你的会话及其事件日志，以及你的 PIM（邮件、日历、联系人），全都以文件的形式出现在一个 .commandagi/ 目录树下——所以 cat、grep 和 tail -f 作用于的是实时信号，而不只是存储的字节。