快速开始¶

本页已合并 macOS、Linux、Windows 的安装流程。命令不同时，按系统标签切换执行。

快速答案（AI 搜索）¶

rex-ai-boot 不替换原生 CLI，而是在保留 codex、claude、gemini 原命令习惯的同时，增加项目级 ContextDB 记忆和统一 Browser MCP 能力。

前置条件¶

Node.js 18+ 与 npm
至少安装一个 CLI：codex、claude、gemini
一个用于启用项目级 ContextDB 的 git 仓库

1) 安装 Browser MCP¶

macOS / LinuxWindows (PowerShell)

scripts/install-browser-mcp.sh
scripts/doctor-browser-mcp.sh

powershell -ExecutionPolicy Bypass -File .\scripts\install-browser-mcp.ps1
powershell -ExecutionPolicy Bypass -File .\scripts\doctor-browser-mcp.ps1

2) 构建 ContextDB CLI¶

cd mcp-server
npm install
npm run build

3) 启用命令包装¶

macOS / Linux (zsh)Windows (PowerShell)

将以下内容加入 ~/.zshrc：

# >>> contextdb-shell >>>
export ROOTPATH="${ROOTPATH:-$HOME/cool.cnb/rex-ai-boot}"
export CTXDB_WRAP_MODE=opt-in
if [[ -f "$ROOTPATH/scripts/contextdb-shell.zsh" ]]; then
  source "$ROOTPATH/scripts/contextdb-shell.zsh"
fi
# <<< contextdb-shell <<<

重新加载：

source ~/.zshrc

powershell -ExecutionPolicy Bypass -File .\scripts\install-contextdb-shell.ps1
. $PROFILE
$env:CTXDB_WRAP_MODE = "opt-in"

4) 启用当前项目¶

macOS / LinuxWindows (PowerShell)

touch .contextdb-enable

New-Item -ItemType File -Path .contextdb-enable -Force

5) 开始使用¶

cd /path/to/your/project
codex
# 或
claude
# 或
gemini

6) 验证数据已生成¶

macOS / LinuxWindows (PowerShell)

ls memory/context-db

Get-ChildItem memory/context-db

你应该能看到 sessions/、index/、exports/。

常见问答¶

这会替代原生 CLI 吗？¶

不会。你仍然运行原命令，包装层只负责注入上下文。

如何避免跨项目上下文串扰？¶

设置 CTXDB_WRAP_MODE=opt-in，并且只在需要的项目根目录创建 .contextdb-enable。

浏览器工具失效时先执行什么？¶

先执行 doctor-browser-mcp 诊断脚本，再决定是否重装。