"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/
Python
Move Nsight Graphics guide into harness README
aimidi7eaf55024ca0
diff --git a/.gitignore b/.gitignoreindex acdc15011..84aad877f 100644--- a/.gitignore+++ b/.gitignore@@ -225,8 +225,6 @@!/safari/!/safari/agent-harness/!/nsight-graphics/agent-harness/-!/nsight-graphics/README.md-!/nsight-graphics/README_CN.md# Step 7: Ignore build artifacts within allowed dirs**/__pycache__/diff --git a/README.md b/README.mdindex 385eea4d7..9a3a39987 100644--- a/README.md+++ b/README.md@@ -958,7 +958,7 @@ Each application received complete, production-ready CLI interfaces — not demo<td align="center">✅ 24</td></tr><tr>-<td align="center"><strong>🟩 <a href="nsight-graphics/">Nsight Graphics CLI</a></strong></td>+<td align="center"><strong>🟩 <a href="nsight-graphics/agent-harness/">Nsight Graphics CLI</a></strong></td><td>GPU Debugging & Profiling</td><td><code>cli-anything-nsight-graphics</code></td><td>Official ngfx / ngfx-capture orchestration + GPU Trace summary</td>@@ -1112,7 +1112,7 @@ cli-anything/├── ☁️ cloudcompare/agent-harness/ # CloudCompare CLI (88 tests)├── 🔍 exa/agent-harness/ # Exa CLI (40 tests)└── ⛅ cloudanalyzer/agent-harness/ # CloudAnalyzer CLI (14 tests)-├── 🟩 nsight-graphics/ # Nsight Graphics CLI (32 tests)+├── 🟩 nsight-graphics/agent-harness/ # Nsight Graphics CLI (32 tests)```Each `agent-harness/` contains an installable Python package under `cli_anything.<software>/` with Click CLI, core modules, utils (including `repl_skin.py` and backend wrapper), and comprehensive tests.diff --git a/nsight-graphics/README.md b/nsight-graphics/README.mddeleted file mode 100644index 0c9003c38..000000000--- a/nsight-graphics/README.md+++ /dev/null@@ -1,81 +0,0 @@-# Nsight Graphics--This directory contains the CLI-Anything integration for **NVIDIA Nsight Graphics**.--It is designed for humans coordinating AI agents as well as for agents calling-the harness directly.--## What This Integration Does--- detects installed Nsight Graphics versions-- selects a specific install with `--nsight-path`-- launches a target or attaches to a running PID-- captures a frame-- collects a GPU Trace report-- summarizes exported GPU Trace timing results-- generates a C++ capture--## Recommended Human-to-AI Prompt Format--Give the AI these fields explicitly:--```text-Nsight version: 2026.1.0-Program: D:/path/to/YourApp.exe-Working dir: D:/path/to-Args: "D:\path\project.uproject" -dx12 -log -newconsole-Action: Graphics Capture / GPU Trace / C++ Capture-Trigger: after 10 seconds / frame 300 / I will press F11-Output: capture path / trace path / top 10 GPU hotspots / summary-```--## Prompt Examples--### Inspect installations--```text-Use the Nsight Graphics harness. List installed versions, tell me which one is selected, and switch to 2026.1.0 if available.-```--### One-step GPU Trace summary--```text-Use Nsight Graphics 2026.1.0 and run a GPU Trace on this executable.-Wait for me to press F11 manually.-After it finishes, give me:-- frame time-- estimated FPS-- draw count and dispatch count-- top 10 GPU events-- short diagnosis of what looks expensive-Program: D:/path/to/App.exe-Working dir: D:/path/to-Args: ...-```--### Automatic frame capture--```text-Launch this program under Nsight Graphics and automatically capture one frame after 10 seconds. Return the capture file path.-```--## Operator Notes--- If multiple Nsight versions are installed, pin one with `--nsight-path`- when reproducibility matters.-- For one-step performance triage, prefer:--```bash-cli-anything-nsight-graphics gpu-trace capture --auto-export --summarize-```--- If a running process is already attached to a different Nsight activity,- ask the AI to launch a fresh process for GPU Trace instead of reusing it.-- This harness is Windows-first and wraps the official CLI tools, not the full GUI.--## Related Docs--- Chinese guide: [README_CN.md](D:\code\D5\CLI-Anything-nsight-graphics-dev\nsight-graphics\README_CN.md)-- Package usage: [agent-harness/cli_anything/nsight_graphics/README.md](D:\code\D5\CLI-Anything-nsight-graphics-dev\nsight-graphics\agent-harness\cli_anything\nsight_graphics\README.md)-- Software notes: [agent-harness/NSIGHT_GRAPHICS.md](D:\code\D5\CLI-Anything-nsight-graphics-dev\nsight-graphics\agent-harness\NSIGHT_GRAPHICS.md)-- Agent skill: [agent-harness/cli_anything/nsight_graphics/skills/SKILL.md](D:\code\D5\CLI-Anything-nsight-graphics-dev\nsight-graphics\agent-harness\cli_anything\nsight_graphics\skills\SKILL.md)diff --git a/nsight-graphics/README_CN.md b/nsight-graphics/README_CN.mddeleted file mode 100644index 939455906..000000000--- a/nsight-graphics/README_CN.md+++ /dev/null@@ -1,78 +0,0 @@-# Nsight Graphics--这个目录包含 **NVIDIA Nsight Graphics** 的 CLI-Anything 集成。--它既面向直接调用 harness 的 AI,也面向“由人来调度 AI 使用这个能力”的工作流。--## 这个能力可以做什么--- 检测本机安装了哪些 Nsight Graphics 版本-- 用 `--nsight-path` 显式选择某个安装版本-- 启动目标程序或附加到已有 PID-- 抓取一帧图形捕获-- 收集一轮 GPU Trace-- 自动总结 GPU Trace 导出的耗时结果-- 生成 C++ Capture--## 推荐的人类提示格式--建议把这些信息明确告诉 AI:--```text-Nsight版本:2026.1.0-程序:D:/path/to/YourApp.exe-工作目录:D:/path/to-参数:"D:\path\project.uproject" -dx12 -log -newconsole-动作:Graphics Capture / GPU Trace / C++ Capture-触发方式:10秒后 / 第300帧 / 我会按 F11-输出:capture 路径 / trace 路径 / Top10 GPU 热点 / 总结-```--## 提示示例--### 查看安装版本--```text-使用 Nsight Graphics harness,列出本机已安装版本,告诉我当前默认选中哪个,如果有 2026.1.0 就切过去。-```--### 一步式 GPU Trace 总结--```text-使用 Nsight Graphics 2026.1.0 对这个程序做一轮 GPU Trace。-等我手动按 F11 触发。-结束后给我:-- 帧时间-- 估算 FPS-- draw count 和 dispatch count-- 最耗时前 10 个 GPU 事件-- 一段简短诊断,说明主要瓶颈在哪里-程序:D:/path/to/App.exe-工作目录:D:/path/to-参数:...-```--### 自动抓帧--```text-用 Nsight Graphics 启动这个程序,10 秒后自动抓 1 帧,并把 capture 文件路径返回给我。-```--## 使用建议--- 多版本共存时,建议始终用 `--nsight-path` 固定版本。-- 如果你想让 AI 一步完成“抓 trace + 导出 + 总结”,优先让它使用:--```bash-cli-anything-nsight-graphics gpu-trace capture --auto-export --summarize-```--- 如果目标进程已经挂在其他 Nsight activity 上,建议让 AI 新起一个进程来跑 GPU Trace。-- 这个 harness 当前是 Windows-first,封装的是官方 CLI,不是完整 GUI 的全部功能。--## 相关文档--- 英文说明:[README.md](D:\code\D5\CLI-Anything-nsight-graphics-dev\nsight-graphics\README.md)-- 包内使用说明:[agent-harness/cli_anything/nsight_graphics/README.md](D:\code\D5\CLI-Anything-nsight-graphics-dev\nsight-graphics\agent-harness\cli_anything\nsight_graphics\README.md)-- 软件说明:[agent-harness/NSIGHT_GRAPHICS.md](D:\code\D5\CLI-Anything-nsight-graphics-dev\nsight-graphics\agent-harness\NSIGHT_GRAPHICS.md)-- Agent 技能:[agent-harness/cli_anything/nsight_graphics/skills/SKILL.md](D:\code\D5\CLI-Anything-nsight-graphics-dev\nsight-graphics\agent-harness\cli_anything\nsight_graphics\skills\SKILL.md)diff --git a/nsight-graphics/agent-harness/cli_anything/nsight_graphics/README.md b/nsight-graphics/agent-harness/cli_anything/nsight_graphics/README.mdindex ba2d302d2..bdaae73c7 100644--- a/nsight-graphics/agent-harness/cli_anything/nsight_graphics/README.md+++ b/nsight-graphics/agent-harness/cli_anything/nsight_graphics/README.md@@ -212,3 +212,31 @@ That gives you:- the `.ngfx-gputrace` artifact- exported `FRAME.xls`, `GPUTRACE_FRAME.xls`, and `D3DPERF_EVENTS.xls`- a parsed summary with frame time, estimated FPS, selected counters, and top GPU events++## Human + AI Workflow++When a human is directing an AI agent, the most effective requests usually specify:++1. which Nsight version to use+2. the target executable+3. the working directory+4. the target arguments+5. the activity to run+6. the trigger condition+7. the artifact or summary to return++Example:++```text+Use Nsight Graphics 2026.1.0 for this executable.+Wait for me to press F11.+After GPU Trace finishes, give me:+- frame time+- estimated FPS+- draw count and dispatch count+- top 10 GPU events+- short diagnosis of the likely bottleneck+Program: D:/path/to/App.exe+Working dir: D:/path/to+Args: "D:\path\project.uproject" -dx12 -log -newconsole+```