FUSE 文件系统接口

Agent runtime 不该藏在数据库里。

CortexFS 在 /ctx 挂载模型、agent、tool 和持久 session——一个可用 ls、cat、执行、安全控制和审计的小型 Unix ABI。

观看项目介绍开始安装 GitHub

017 个稳定根名称02通过 FUSE 挂载03受策略约束04持久 JSONL

稳定的根 ABI$ ls /ctx

statusbinmodelagenttoolhomeshared

modelmodel 是纯推理文件：读取元数据，执行一次推理。

项目介绍

快速了解 CortexFS。

从 /ctx 的稳定 ABI，到 model、agent、tool 与持久 session 的整体设计。

真实运行，而非概念图

看 runtime 真正在工作。

真实 CortexFS CLI 与 coder agent 交互；命令、tool 调用和 session 路径仍然直接可见。

三类可执行对象，一份持久历史

Runtime 的关键部分都能被直接操作。

CortexFS 只提供三类可执行对象，并用普通文件保存 session 历史，让 shell、权限和普通文件承担它们已经擅长的工作。

01model

模型是纯推理文件

读取文件得到元数据，执行文件完成一次推理。供应商连接与 API 格式差异留在统一模型 ABI 之后。

/ctx/model/main → gpt-5.6-sol · kimi-k3

02agent

Agent 是受策略约束的编排者

Agent 以可执行对象和 socket 暴露；Linux 身份、mount、cwd、model 与 policy 共同限定它能看见和执行什么。

/ctx/agent/coder  +  coder.sock

03tool

Tool 是可执行能力端点

Agent 通过 tsh 调用 tool。tsh 只沿 CTX_PATH 查找能力，不会回退到 host PATH。

CTX_PATH=/ctx/tool:/ctx/home/<uid>/tool

04session

Session 保存原始历史

messages.jsonl 与 events.jsonl 持久追加；prompt context 是可丢弃、可重建的工作集。

session/default/{messages,events}.jsonl

可审计的权限边界

Linux 权限与 runtime policy 在路径上相交。

mount ∩ uid/gid/mode ∩ policy ∩ CTX_PATH ∩ noexec

可见性不是 prompt 里的承诺。mount、uid/gid/mode bits、CortexFS policy、CTX_PATH 与 noexec 共同形成 agent 的实际权限。

供应商中立

变化的 API 之上，保持一个稳定 ABI。

one ABI / changing APIs

CortexFS 负责路径、对象生命周期、权限与 session 语义；Rig 负责供应商连接和 API 事件适配。供应商细节不会膨胀成新的根目录。

看见mount ∩ uid/gid/mode

发现CTX_PATH

执行policy ∩ noexec

最终权限 = 所有边界的交集root 只包含稳定对象类别

快速开始

三步，从安装包到真实对话。

下面就是当前 README 使用的安装、挂载与交互命令。

阅读完整安装文档 →

01
安装
从 AUR 安装 CortexFS。
```
paru -S cortexfs-git
```
02
挂载并验证
启动 systemd FUSE 挂载，然后检查有效状态。
```
sudo systemctl enable --now cortexfs.service
ctx doctor
```
03
初始化并聊天
生成默认对象，启动 coder，再进入首选人类聊天界面。
```
ctx bootstrap
ctx agent start coder
ctx agent chat coder
```

让 runtime 回到 Unix

小到足以审计，实用到足以构建。

从规范理解稳定边界，在 GitHub 查看实现，或直接挂载 /ctx 开始使用。

阅读规范 GitHub 开始安装