为 Codex CLI、Claude Code、Gemini CLI 等编码 Agent 提供本地优先的统一记忆系统与编排层
RexCLI（CLI 命令 aios）是一个 Local-first AI Agent 启动工具，在不替代上游 CLI 模型调用能力的前提下，为 Codex CLI、Claude Code、Gemini CLI、OpenCode 等编码 Agent 提供三大共享基础设施：基于 better-sqlite3 的跨 CLI 持久化记忆系统（ContextDB）、基于 Playwright MCP 的统一浏览器自动化（browser_* 工具集，支持 CDP 连接）、以及自动隐私脱敏的 Privacy Guard。
共享基础设施#
- ContextDB：跨 CLI 文件系统持久化存储，支持 session / event / checkpoint / context:pack 等子命令，基于 better-sqlite3（需 Node ABI 匹配）
- 统一浏览器自动化：Playwright MCP Server 提供标准化
browser_*工具集，支持 CDP（Chrome DevTools Protocol）连接 - Privacy Guard：读取配置/密钥类文件前自动执行隐私脱敏，配置存储于
~/.rexcil/privacy-guard.json，可选本地 Ollama（qwen3.5:4b）路径
Operator 工具箱#
- Quality Gate：
aios quality-gate full/pre-pr --profile strict，仓库健康度 + ContextDB 回归守卫 - Learn-Eval：
aios learn-eval --limit 10，将 checkpoint telemetry 转为可操作建议 - Orchestrate：蓝图编排 + 本地调度骨架 + token-free dry-run；
--dispatch local --execute live进行实际模型调用 - Team Runtime：
aios team 3:codex "Ship X"，多 Agent 并行协作，支持 dry-run / resume / retry-blocked - HUD：
aios hud --provider codex --watch --preset full，会话可见性面板 - Snapshot Rollback：变更前快照 + 事后回滚，用于 incident recovery
Skills 系统#
规范化的 skill source tree，支持 global 和 project 两种作用域。核心 skill 集包括：skill-constraints、aios-project-system、aios-long-running-harness、contextdb-autopilot 等，通过 TUI 的 SkillPickerScreen 进行交互式安装/卸载。
架构与调用链路#
User → codex/claude/gemini
→ (zsh wrapper: contextdb-shell.zsh)
→ contextdb-shell-bridge.mjs
→ ctx-agent.mjs
→ contextdb CLI (init/session/event/checkpoint/pack)
→ start native codex/claude/gemini (with context packet)
→ mcp-server/browser_* (optional browser automation)
用户调用原生 CLI 命令时，由 zsh wrapper 透明拦截，经 bridge 桥接后由 ctx-agent.mjs 完成 ContextDB 的会话初始化与上下文打包，最终携带 context packet 启动原生 CLI，并可选注入 MCP browser_* 工具。
上游 Agent 集成#
- Codex CLI：深度适配 v0.114+ structured exec outputs（
--output-schema+--output-last-message+ stdin），旧版回退 stdout 解析 - Claude Code / Gemini CLI：通过 Shell Wrapper 统一接入
- OpenCode：文档提及支持
安装与前置要求#
运行时严格要求 Node.js 22 LTS（"engines": { "node": ">=22 <23" }），支持 macOS、Linux 和 Windows（PowerShell）平台。
macOS / Linux 一键安装：
curl -fsSL https://github.com/rexleimo/rex-cli/releases/latest/download/aios-install.sh | bash
source ~/.zshrc
aios
Windows PowerShell 一键安装：
irm https://github.com/rexleimo/rex-cli/releases/latest/download/aios-install.ps1 | iex
. $PROFILE
aios
关键环境变量#
| 变量 | 说明 |
|---|---|
AIOS_SUBAGENT_CLIENT | 子 Agent 客户端：codex-cli / claude-code / gemini-cli |
AIOS_SUBAGENT_CONCURRENCY | 并发子 Agent 数量 |
AIOS_EXECUTE_LIVE | 设为 1 启用实际模型调用的 live 执行 |
AIOS_SUBAGENT_PRE_MUTATION_SNAPSHOT | 设为 1 在 live 执行前创建文件快照 |
CTXDB_WRAP_MODE | repo-only（默认）/ opt-in（需 .contextdb-enable 标记） |
RL 实验模块#
仓库内含 experiments/rl-shell-v1，提供 RL（强化学习）实验基础设施，包含 benchmark、训练（phase 2A）、评估（phase 2B）、campaign 等脚本，生产就绪状态未明确。
待确认信息#
- 仓库根目录未发现 LICENSE 文件，开源许可证类型无法确认
- 未发现关联的 Hugging Face 模型页或学术论文引用
- Privacy Guard 本地 Ollama 路径的具体模型能力待验证