nx-rp（npx-repo）

项目外部上下文信息管理，让项目开发更轻。

nx-rp = npx-repo 的缩写。给当前项目（cwd）统一登记项目开发用得着的外部信息（源码依赖图、提示词日志、Skill 追踪、文件批注……），存在 ~/.nx-rp/store.json，按 cwd 自动隔离 scope。

• 图表（chart）：项目图表域——面板「依赖图」（扫 src/ 的 import 关系）+ 「图表」 （archify 产物登记展示）双视图同源模块。dot 侧 Graphviz WASM 渲染、分层着色、 跨层边红；只读——从源码推导。archify 侧图一律出自 archify skill 的精修流程， agent 用 /archify 画图后 chart archify add 登记，多图下拉切换，见 rp-archify skill
• 提示词日志（hook）：Claude Code UserPromptSubmit hook——每次提交的提示词按目录记进本地 JSONL；面板里有「提示词日志」页

CLI 与 Web 面板同源（一条 action 同时声明 CLI 与 HTTP）。agent 通过 CLI 自助管理。

存储：~/.nx-rp/store.json（全局），按 cwd 自动隔离 scope。

GitHub: https://github.com/On-DevPlan/nx-rp

快速开始

npx nx-rp serve               # 打开 http://127.0.0.1:7820
npx nx-rp skill install       # 把内置 skill 装到 ~/.claude/skills
npx nx-rp routes              # 看 CLI ↔ Web 路由对照

命令速查

nx-rp serve                  启动 Web 面板（默认 :7820；端口上已有 nx-rp 面板则
                             登记当前目录到「最近目录」并直接打开它，不重复起进程；
                             被别的服务占用则顺延到下一个空闲端口；--no-open 与
                             NX_SERVE_NO_OPEN=1 不开浏览器）
nx-rp recents                最近使用的工作目录（面板可一键切换数据范围）
nx-rp recents remove <path>  从最近目录列表移除（不存在的路径也返回 not_found；面板右上角 hover 条目右侧的 × 同效）
nx-rp skill install          装内置 skill 到 ~/.claude/skills（默认装 nx-rp）
nx-rp skill install --group=rp-loop   按 group 装另一个内置 skill
                             （group 名即 skill 名，等价 `skill install rp-loop`；
                             `--group` 与位置参数二选一，同时给会报错）
nx-rp skill groups           列出内置 group（含降级到目录扫描时的标注）
nx-rp skill get              把内置 skill 文档（SKILL.md / references/*）输出到 stdout；
                             同时按 install 既有逻辑装到 ~/.claude/skills——给不直接
                             识别 ~/.claude/skills 的 agent 一条命令拿全上下文
nx-rp help                   列出全部命令
nx-rp routes                 命令 ↔ 路由对照表
nx-rp bootstrap --json       一次性拿齐上下文
nx-rp chart                  扫 src/ 的 import 关系 → 依赖图（DOT 文本；
                             --json 拿 {nodes, edges, stats}；面板可视化）
nx-rp chart save --file <f>  依赖图 DOT 落盘为 .dot 文件（graphviz 交接）
nx-rp chart load --file <f>  读外部 .dot 文本（导入预览）
nx-rp chart archify list     已登记的 archify 图表（面板「图表」模式数据源）
nx-rp chart archify add      把 archify 产物 HTML 拷入 scope 存储并登记
nx-rp chart archify discover / remove / view    发现产物 / 移除登记 / 查看路径
nx-rp hook on                启用提示词日志 hook（写 ~/.claude/settings.json）
nx-rp hook log               看当前目录的提示词记录（--all 跨目录）
nx-rp hook off               停用（只摘自己的 entry，其余 hooks 不动）
nx-rp hook skill-on / skills 启用 Skill 追踪 / 看 skill 使用统计与健康分
nx-rp loop on                在当前项目启用循环 hook（写 .claude/settings.local.json，
                             不写全局——只有本项目会被拦截退出；自动补 .gitignore 忽略行）
nx-rp loop start "<任务>"    布防自引用循环：Stop hook 反复灌回这条提示词，
                             --completion-promise DONE 出现 <promise>DONE</promise> 即结束，
                             --max-iterations N 兜底（默认 20，0 = 无限）
nx-rp loop status            看 hook 开关 + 当前目录的循环与轮次
nx-rp loop log               看每轮判定审计（继续/命中/超限；--all 跨目录）
nx-rp loop cancel            取消循环（不带 --id 则取消全部活跃）
nx-rp loop off               停用（本地级+项目级都摘，其余 hooks 不动）
nx-rp ann load / add         加载文件预览（1000 字符限）/ 挂批注（评价/待办/思考）
nx-rp ann todos              跨文件的未完成待办清单

加 --json 到任何命令得机器可读输出。

多项目 / 最近目录

数据按工作目录隔离（cwd scope）。在一个面板里管理多个项目：

• 每次在任何项目目录执行 nx-rp serve，该目录会被自动登记进「最近目录」—— 如果默认端口上已经有面板在跑，不会再起第二个进程，直接打开它
• 端口被别的服务占用时自动顺延到下一个空闲端口起面板，并打开浏览器指向新面板； NX_SERVE_NO_OPEN=1（所有 nx-xx 项目通用）或 --no-open 可关掉自动开浏览器
• 面板右上角「最近目录」下拉可切换数据范围：切换后的查看/新增/编辑都落到那个目录
• 下拉自动跟随最新触发：另一终端刚跑过 nx-rp serve、或在面板下拉底 部点"+ 添加目录"输入路径，都会被自动切到那个目录
• 鼠标悬停条目右侧的 × 可移除该条目（等价 nx-rp recents remove <path>）
• 想真正并行开两个面板：nx-rp serve --port 7830 显式指定端口

开发

pnpm install
pnpm dev          # vite + serve 双进程
pnpm start        # 生产模式：build + serve
pnpm test         # lint + build + smoke + unit

License

MIT