python3 scripts/verify_fake_sample.py   # 自动回归（推送前已跑通）
# 人工对照预期：fake_sample/verify.md
ccg index fake_sample && ccg query --namespace nsA::moduleB --kind coroutine

git clone https://github.com/ArcherLin13/cpp-coro-graph.git
cd cpp-coro-graph

# 把 `ccg` 放到 PATH（~/.local/bin）— 不需要 pip
chmod +x scripts/*.sh scripts/ccg scripts/cpp-coro-graph
./scripts/install_cli.sh
# 确保 ~/.local/bin 已加入 PATH

# 或者：可编辑安装
python3 -m pip install -e .

ccg index /path/to/repo          # 生成 .cpp-coro-graph/graph.db
cd /path/to/repo                 # --db 会向上自动发现

ccg status
ccg status --by-namespace
ccg query OnSos
ccg query --kind file processor.h
ccg query --namespace nsA::moduleB --kind coroutine
ccg node OnSos                   # symbol: callers + callees
ccg node file:src/foo.cpp        # file: contains / includes / importers
ccg callers OnSos
ccg callees OnSos
ccg seq OnSos                    # ordered calls/await inside a function
ccg explore OnSos                # in/out + wider neighborhood
ccg path Call Init               # control path A → B（file 查询则走 includes）
ccg impact OnSos
ccg viz --module path/to/module

ccg index /path/to/your/linux/repo
# 或者一条命令完成 index + HTML + status
./scripts/index_repo.sh /path/to/your/linux/repo

ccg sync /path/to/your/linux/repo
# 或在仓库根目录（自动发现 .cpp-coro-graph/graph.db）
cd /path/to/your/linux/repo && ccg sync

python3 scripts/validate_fixtures.py          # aigc + pipeline + sample
ccg index fixtures/aigc --db /tmp/aigc.db
ccg node run_pipeline --db /tmp/aigc.db
ccg path run_pipeline Init --db /tmp/aigc.db

ccg viz --module path/to/module --depth 2
ccg viz --around Call --depth 2
ccg viz --full          # 旧版全图模式，大工程不建议

# 1) 先保证 CLI 在 PATH
./scripts/install_cli.sh          # 或者: pip install -e .

# 2) 对你的 C++ 仓库建库（这一步必须做；MCP 不会帮你做）
ccg index /path/to/your/repo
# 之后改代码：ccg sync

# 3) 写入 OpenCode 配置（项目级或全局）
cd /path/to/your/repo
ccg install-opencode --agents     # 写入 ./opencode.json + AGENTS.md 提示
# 或用户级：
ccg install-opencode --global

# 4) 重启 OpenCode 并检查
opencode mcp list

# 1) 看 install 写进去的真实 command
ccg install-opencode --agents --db /abs/path/.cpp-coro-graph/graph.db
# 会打印: mcp command: ["/usr/bin/python3", "-u", ".../scripts/ccg_mcp.py", "--db", "..."]

# 2) 手动跑同一条 command（应卡住等 stdin，stderr 有 mcp entry 日志）
python3 -u /path/to/cpp-coro-graph/scripts/ccg_mcp.py --db /abs/path/graph.db
# Ctrl+C 退出。如果立刻 ModuleNotFoundError / 找不到文件 → 先修这个

# 3) 确认 opencode.json 里是 type=local + command 数组（不要用 args/env 旧字段）

cd /path/to/your/repo
ccg index .
ccg install-opencode --agents --db "$(pwd)/.cpp-coro-graph/graph.db"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cpp-coro-graph": {
      "type": "local",
      "command": ["ccg", "mcp"],
      "enabled": true,
      "timeout": 15000
    }
  }
}

{
  "mcpServers": {
    "cpp-coro-graph": {
      "command": "ccg",
      "args": ["mcp"]
    }
  }
}

{
  "patterns": [
    {"match": "RunOnNpu", "device": "npu", "backend": "custom"},
    {"match": "clEnqueue", "device": "gpu", "backend": "opencl"}
  ]
}

ccg callees Call                    # 按顺序输出 #1 Init, #2 Load, …
ccg explore Init --edge-kind seq    # Init -[seq]-> Load（在 Call 中的下一步）
ccg viz --module .