Quick Start¶

This page combines macOS, Linux, and Windows setup into one flow. Use the OS tabs when commands differ.

Prerequisites¶

Node.js 18+ and npm
At least one CLI installed: codex, claude, or gemini
A git repository where you want project-scoped ContextDB memory

1) Install 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) Build ContextDB CLI¶

cd mcp-server
npm install
npm run build

3) Enable command wrappers¶

macOS / Linux (zsh)Windows (PowerShell)

Add this block to ~/.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 <<<

Reload shell:

source ~/.zshrc

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

4) Enable current project¶

macOS / LinuxWindows (PowerShell)

touch .contextdb-enable

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

5) Start working¶

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

6) Verify data created¶

macOS / LinuxWindows (PowerShell)

ls memory/context-db

Get-ChildItem memory/context-db

You should see sessions/, index/, and exports/.