┌──────────────┐    MCP over HTTPS    ┌────────────────────┐   子进程    ┌──────────────┐
│ ChatGPT 网页 │ ───────────────────► │ chat-with-hermes   │ ─────────► │ bash / codex │
│  （思考）    │ ◄─────────────────── │ 本地 MCP 服务 :8770│ ◄───────── │  （执行）    │
└──────────────┘   工具结果回到上下文  └────────────────────┘    输出     └──────────────┘
                                             │
                                       data/audit.jsonl（谁在什么时候干了什么）

# 方式一：pipx（推荐）
pipx install git+https://github.com/00000linlin/chat-with-hermes

# 方式二：uv
uv tool install git+https://github.com/00000linlin/chat-with-hermes

# 方式三：克隆即用（免安装）
git clone https://github.com/00000linlin/chat-with-hermes && cd chat-with-hermes
./cwh doctor

cwh setup        # 生成 ~/.chat-with-hermes/{config.toml, data/token.txt}
cwh start        # 起本地 MCP 服务（默认 0.0.0.0:8770）
cwh tunnel       # 自动下载 cloudflared 起隧道，打印「连接器 URL」

cwh status          # 服务/隧道/待批准/最近访问
cwh log             # 服务日志（data/server.log）
cwh pending         # 待批准命令（--all 连历史）
cwh approve <id>    # 批准并执行
cwh reject <id>     # 拒绝
cwh selftest        # 把 9 个工具全打一遍
cwh doctor          # 体检（Python 版本、配置、端口、Codex、cloudflared）
cwh url             # 只打印连接器 URL

[server]
host = "0.0.0.0"
port = 8770
data_dir = "~/.chat-with-hermes/data"

[workspace]
roots = ["/home/you/projects"]   # 想让它碰几个目录就写几行
allow_write = true

[shell]
mode = "guard"                   # guard（推荐）| auto（全放行）

[codex]
enabled = true
bin = "codex"
sandbox = "workspace-write"      # read-only | workspace-write | danger-full-access

pipx install git+https://github.com/00000linlin/chat-with-hermes
cwh setup && cwh start && cwh tunnel     # prints a connector URL