Skip to content

"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/.gitignore
index 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.md
index 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.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.md
index 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
+```