Your sessions. Your context. Your next step.
macOS 上的 coding-agent 工程支持层。把散落在 Claude Code、Codex 和 Cursor 里的会话，留成下一次可以接着用的工程上下文。查看证据、保存项目记忆，先审阅再执行工作流。数据由你持有，工具保持熟悉。
git clone https://github.com/Atingaii/Vela.git
为 Coding Agent 提供清晰的工程抓手
面向会话回看、项目记忆沉淀、只读工作流预演及实验对照。无需推翻现有工作习惯，把不可逆修改留在单次审批之后。
找到改动的来由
从 Claude Code、Codex 和 Cursor 的会话日志中精准检索关键工具调用与上下文证据，核对决策依据。
保留值得复用的约束
将构建方式、验证规则等确切工程约束保存为 Candidate 提案，人工激活后按预算词面召回，过时显式归档。
先检查，再允许修改
在执行本地工程操作前通过 Dry Run 预演变更计划，在 Inbox 冻结参数审查后单次批准执行，并保留 Undo 事务日志。
保留证据与不确定性
在配对隔离的 Git Worktree 中执行同任务 Baseline 与 Candidate 对照评估，由独立 Verifier 判定真实边界。
让散落的智能体会话，
成为可复用的经验。
会话结束不代表经验归零。Vela 在本地监听已连接项目的日志流，把工具调用过程与代码修改沉淀为清晰的上下文记录。
-
多智能体日志捕获：自动发现 Claude Code 与 Codex 会话日志（Cursor 格式为只读导入），初次导入采用有界读取以缓解 I/O 与内存开销。
-
基于日志推断会话状态：严格根据支持的本地日志证据推断调用时间线与状态，非后台实时进程存活性证明；缺失存活证据即如实标注为未知。
-
经验沉淀为 Candidate 记忆：点按消息即可沉淀为项目记忆提案，在 Candidate ➔ Active 流转中经人工审核，避免无关碎片污染检索。
运行状态由本地日志最新事件推断得出，非独立系统守护进程探针；初次导入限制选取 60 个日志文件并读取 256KB 尾窗，不提供全量历史回溯保证。
先看只读试运行。
确认后，再执行。
把日常重复的 Git 检查、环境验证与本地构建串联成受控管道。每一步潜在变更都经过严格参数哈希冻结，避免非预期的文件写入与命令调用。
-
Dry Run 安全预演：只读 Git 命令（status/diff/log）在当前工作区真实执行；写入与测试脚本采用安全 stub 拦截，预演无破坏性副作用。
-
待办把关 (Inbox) 与参数冻结：工作流中的文件修改与测试命令在计算冻结参数哈希后进入待办列表，由工程师明确单次批准后方可执行。
-
单次批准原则：审批仅对已核准的具体参数生效一次，不针对不确定的远程副作用进行自动重试，使执行动作严格限定在已审查范围。
Dry Run 对写操作执行 stub 拦截，预演成功仅代表计划校验通过，不证明底层测试已真实执行；目前仅支持受管本地目录文件与命令，不支持任意未审查的外部 SaaS 自动化。
工程资料，由你持有。
无需云端账号。
采用 Swift、AppKit 原生桌面宿主与内置 SQLite 引擎，不捆绑任何 Electron、Chromium 或 Node.js 运行时。资产明文可读、去留完全由你掌控。
-
明文 Markdown 与本地 SQLite：长期工程资产采用人类可读的 Markdown 文件存储，快速检索与审计流水由纯本地 SQLite 驱动。
-
私密库严格隔离：在 Private Library 中的私密条目被底层强行阻断在 MCP 与智能体上下文检索之外，保护个人敏感笔记与凭据。
-
受限预算词面召回 (Recall)：CLI 默认以固定 1000 Token 预算召回处于 Active 状态的记忆，智能体启动时不自动拉取，无远程向量服务依赖。
Vela 无内置商业遥测；但显式触发的 URL 导入与用户明确批准的远程 CLI 仍可联网，请勿将本地优先误解为物理隔离或绝对防泄露保证。
在本地运行 Vela。
接续下一次工程会话。
适用于 Apple Silicon (macOS 13+) 的开发者预览构建。无需在线注册，下载即用，会话与工程记忆始终保存在本地。
安全提示：当前构建为 ad-hoc 签名，尚无 Developer ID 签名和 Apple 公证。首次打开若遇系统安全提示，请前往 macOS「系统设置 ➔ 隐私与安全性」点击“仍要打开”。亦支持通过官方代码仓库本地源码编译安装。