"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/
Python
Expand Unreal Insights capture orchestration and docs
aimidi6e45b7a98d07
diff --git a/.gitignore b/.gitignoreindex 6c533bfad..bac27a596 100644--- a/.gitignore+++ b/.gitignore@@ -16,12 +16,15 @@!/CONTRIBUTING.md!/SECURITY.md!/assets/+!/.pi-extension/+/.pi-extension/cli-anything/node_modules!/.claude-plugin/!/.github//.github/*!/.github/workflows/!/.github/scripts/!/.github/PULL_REQUEST_TEMPLATE.md+!/.github/ISSUE_TEMPLATE/# Allow examples directory!/examples/@@ -48,6 +51,7 @@!/skill_generation/!/openclaw-skill/!/cli-hub-meta-skill/+!/cli-hub/# Ignore cli-hub-skill (auto-generated, not tracked)/cli-hub-skill/@@ -67,20 +71,29 @@!/zoom/!/sketch/!/drawio/+!/godot/!/mermaid/!/comfyui/+!/dify-workflow/!/adguardhome/!/novita/!/ollama/!/browser/+!/seaclip/+!/pm2/+!/chromadb/!/musescore/!/krita/!/freecad/!/iterm2/!/slay_the_spire_ii/+!/eth2-quickstart/!/rms/!/renderdoc/!/cloudcompare/+!/openscreen/+!/n8n/+!/obsidian/!/unrealinsights/# Step 5: Inside each software dir, ignore everything (including dotfiles)@@ -112,16 +125,26 @@/sketch/.*/drawio/*/drawio/.*+/godot/*+/godot/.*/mermaid/*/mermaid/.*/comfyui/*/comfyui/.*+/dify-workflow/*+/dify-workflow/.*/adguardhome/*/adguardhome/.*/ollama/*/ollama/.*/browser/*/browser/.*+/seaclip/*+/seaclip/.*+/pm2/*+/pm2/.*+/chromadb/*+/chromadb/.*/musescore/*/musescore/.*/krita/*@@ -132,12 +155,26 @@/iterm2/.*/slay_the_spire_ii/*/slay_the_spire_ii/.*+/eth2-quickstart/*+/eth2-quickstart/.*/rms/*/rms/.*/renderdoc/*/renderdoc/.*/cloudcompare/*/cloudcompare/.*+/openscreen/*+/openscreen/.*+/cloudanalyzer/*+/cloudanalyzer/.*+/wiremock/*+/wiremock/.*+/exa/*+/exa/.*+/n8n/*+/n8n/.*+/obsidian/*+/obsidian/.*/unrealinsights/*/unrealinsights/.*@@ -156,22 +193,40 @@!/zoom/agent-harness/!/sketch/agent-harness/!/drawio/agent-harness/+!/godot/agent-harness/!/mermaid/agent-harness/!/comfyui/agent-harness/+!/dify-workflow/agent-harness/!/adguardhome/agent-harness/!/novita/agent-harness/!/ollama/agent-harness/!/browser/agent-harness/+!/seaclip/agent-harness/+!/pm2/agent-harness/+!/chromadb/agent-harness/!/musescore/agent-harness/!/krita/agent-harness/!/freecad/agent-harness/!/iterm2/agent-harness/!/slay_the_spire_ii/agent-harness/!/slay_the_spire_ii/README.md+!/eth2-quickstart/agent-harness/!/rms/agent-harness/!/renderdoc/agent-harness/!/cloudcompare/agent-harness/+!/openscreen/agent-harness/+!/cloudanalyzer/+!/cloudanalyzer/agent-harness/+!/wiremock/+!/wiremock/agent-harness/+!/exa/agent-harness/+!/n8n/agent-harness/+!/obsidian/agent-harness/+!/safari/+!/safari/agent-harness/!/unrealinsights/agent-harness/+!/unrealinsights/README.md+!/unrealinsights/README_CN.md# Step 7: Ignore build artifacts within allowed dirs**/__pycache__/@@ -197,6 +252,7 @@ assets/gen_typing_gif.py# Step 10: Allow CLI Hub registry and frontend!/registry.json+!/public_registry.json!/docs//docs/*!/docs/hub/@@ -205,5 +261,5 @@ assets/gen_typing_gif.py/notebooklm/*/notebooklm/.*!/notebooklm/agent-harness/-!/intelwatch/agent-harness/!/intelwatch/+!/intelwatch/agent-harness/diff --git a/README.md b/README.mdindex ece60f457..cb6924e3a 100644--- a/README.md+++ b/README.md@@ -5,15 +5,17 @@CLI-Anything: Bridging the Gap Between AI Agents and the World's Software</strong><br></p>-**🌐 [CLI-Hub](https://hkuds.github.io/CLI-Anything/)**: Explore all community-built CLIs and install with one command at the **[CLI-Hub](https://hkuds.github.io/CLI-Anything/)**. Want to add your own? [Open a PR](https://github.com/HKUDS/CLI-Anything/blob/main/CONTRIBUTING.md) — the hub updates instantly.+**🌐 [CLI-Hub](https://hkuds.github.io/CLI-Anything/)**: `pip install cli-anything-hub` then `cli-hub install <name>` — browse, install, and manage all community-built CLIs. Want to add your own? [Open a PR](https://github.com/HKUDS/CLI-Anything/blob/main/CONTRIBUTING.md) — the hub updates instantly.**🎬 [See Demos](#-real-world-demos)**: Watch AI agents use generated CLIs to produce real artifacts — diagrams, gameplay, subtitles, and more.+**🙋 [Become a Contributor, or Request a CLI]**: [Join us](https://github.com/HKUDS/CLI-Anything/issues/new?template=contributor-signup.yml)! Sign up to build a new CLI harness — once reviewed and merged, you'll gain access as one of our community contributors! Wish CLI-Anything supported a specific software or service? Submit a [wishlist request](https://github.com/HKUDS/CLI-Anything/issues/new?template=cli-wishlist.yml)!+<p align="center"><a href="#-quick-start"><img src="https://img.shields.io/badge/Quick_Start-5_min-blue?style=for-the-badge" alt="Quick Start"></a><a href="https://hkuds.github.io/CLI-Anything/"><img src="https://img.shields.io/badge/CLI_Hub-Browse_%26_Install-ff69b4?style=for-the-badge" alt="CLI Hub"></a><a href="#-demonstrations"><img src="https://img.shields.io/badge/Demos-16_Apps-green?style=for-the-badge" alt="Demos"></a>- <a href="#-test-results"><img src="https://img.shields.io/badge/Tests-1%2C839_Passing-brightgreen?style=for-the-badge" alt="Tests"></a>+ <a href="#-test-results"><img src="https://img.shields.io/badge/Tests-2%2C130_Passing-brightgreen?style=for-the-badge" alt="Tests"></a><a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge" alt="License"></a></p>@@ -27,7 +29,7 @@ CLI-Anything: Bridging the Gap Between AI Agents and the World's Software</stron<a href="https://github.com/HKUDS/.github/blob/main/profile/README.md"><img src="https://img.shields.io/badge/WeChat-Group-C5EAB4?style=flat&logo=wechat&logoColor=white" alt="WeChat"></a></p>-**One Command Line**: Make any software agent-ready for OpenClaw, nanobot, Cursor, Claude Code, etc. [**中文文档**](README_CN.md) | [**日本語ドキュメント**](README_JA.md)+**One Command Line**: Make any software agent-ready for Pi, OpenClaw, nanobot, Cursor, Claude Code, etc. [**中文文档**](README_CN.md) | [**日本語ドキュメント**](README_JA.md)<p align="center"><img src="assets/cli-typing.gif" alt="CLI-Anything typing demo" width="800">@@ -43,7 +45,37 @@ CLI-Anything: Bridging the Gap Between AI Agents and the World's Software</stron> Thanks to all invaluable efforts from the community! More updates continuously on the way everyday..-- **2026-03-30** 🏗️ **CLI-Anything v0.2.0** — HARNESS.md progressive disclosure redesign. Detailed guides (MCP backend, filter translation, timecode, session locking, PyPI publishing, SKILL.md generation) extracted into `guides/` for on-demand loading. Phases 1–7 now contiguous. Key Principles and Rules merged into a single authoritative section. Added Guides Reference routing table. Renamed "Critical Lessons Learned" to "Architecture Patterns & Pitfalls."+- **2026-04-15** 🌐 **CLI-Hub** updated to **v0.2.0** — the PyPI package now supports public CLIs from multiple install sources (`pip`, `npm`, `brew`, bundled/system tools), backed by a new `public_registry.json`. The Hub frontend was redesigned with separate **CLI-Anything CLIs** and **Public CLIs** decks, and live end-to-end checks now cover real install, update, and uninstall flows across both pip and npm packages.++- **2026-04-14** 🧭 **Safari CLI** merged (#212) and added to the Hub registry — browser automation via `safari-mcp`. 🎬 **Kdenlive** also received compatibility fixes for Gen 5 project output and invalid project generation.++- **2026-04-13** 📓 **Obsidian CLI** merged (#211) — knowledge management harness via the Local REST API, with 48 unit tests and 7 E2E tests. ⛓️ **Eth2-Quickstart CLI** merged (#195) — Ethereum staking node management harness. 📚 **Zotero CLI** updated to v0.4.1 (#201) — now shipped from its standalone repo, and CLI-Hub gained support for remote `skill_md` URLs.++- **2026-04-11** 🔗 **n8n CLI** merged (#188) — workflow automation harness for self-hosted automation flows. 🔧 **Exa CLI** fix (#205) added the `x-exa-integration` header for usage tracking. 📦 **CLI-Hub** also gained its PyPI auto-publish workflow and package refresh pipeline.++- **2026-04-10** 📦 **CLI-Hub package manager** launched — `pip install cli-anything-hub` to browse, search, install, update, and uninstall CLI-Anything harnesses from one command. The web Hub also shipped its first install-focused frontend refresh and "Empower yourself" toolkit card.++<details>+<summary>Earlier news (Apr 1–9)</summary>++- **2026-04-09** 🧹 Cleanup and docs pass (#200) — fixed Openscreen test subtotals, added Openscreen to the Chinese README and project structure, and clarified `/cli-anything` command syntax in the docs.++- **2026-04-08** 🎬 **Openscreen CLI** merged (#183) — screen recording editor harness with 101 tests. ☁️ **CloudAnalyzer CLI** merged (#181) — cloud cost analysis harness with 27 commands. 🌊 **SeaClip / PM2 / ChromaDB** harnesses merged (#129).++- **2026-04-07** 🔄 **Dify Workflow CLI** merged (#191) — workflow automation wrapper. 🔧 **Inkscape** auto-save fix (#193, fixes #182). 🛡️ **DomShell security hardening** (#156) — URL validation and DOM sanitization for the browser CLI. 🥧 **Pi Coding Agent extension** merged (#178).++- **2026-04-06** 🔍 **Exa CLI** merged (#172) — AI-powered web search and answers harness. 🎮 **Godot CLI** merged (#140) — game engine harness with a full demo-game E2E pipeline. ☁️ **CloudAnalyzer** review fixes and frontend improvements also landed.++- **2026-04-03** 🧪 **WireMock CLI** merged (#170) — HTTP mock server harness for API testing. 🥧 **Pi Coding Agent** extension support also landed, and CLI demo recordings were added to the docs.++- **2026-04-01** ⚔️ **Slay the Spire II CLI** merged (#148) — deck-building roguelike harness. 🎥 **VideoCaptioner CLI** merged (#166) — AI-powered video captioning harness. 🛰️ **IntelWatch** was added to the registry for B2B OSINT workflows.++</details>++<details>+<summary>Earlier news (Mar 23–30)</summary>++- **2026-03-30** 🏗️ **CLI-Anything v0.2.0** — HARNESS.md progressive disclosure redesign. Detailed guides extracted into `guides/` for on-demand loading. Phases 1–7 now contiguous. Key Principles and Rules merged into a single authoritative section.- **2026-03-29** 📐 Blender skill docs updated — enforce absolute render paths and correct prerequisites.@@ -53,14 +85,16 @@ CLI-Anything: Bridging the Gap Between AI Agents and the World's Software</stron- **2026-03-26** 📖 **Zotero CLI** harness landed for Zotero desktop (library management, collections, citations). Draw.io custom ID bugfix (#132) and registry.json syntax fix.-- **2026-03-25** 🎮 **RenderDoc CLI** merged for GPU frame capture analysis (PSO compute, REPL capture cache). FreeCAD updated for v1.1 (new datum system, tapping, simulation). Blender EEVEE engine name corrected. Zoom token permissions hardened.+- **2026-03-25** 🎮 **RenderDoc CLI** merged for GPU frame capture analysis. FreeCAD updated for v1.1. Blender EEVEE engine name corrected. Zoom token permissions hardened.-- **2026-03-24** 🏭 **FreeCAD CLI** added with 258 commands across 17 groups. **iTerm2** and **Teltonika RMS** harnesses added to registry. CLI-Hub frontend and README install URLs updated.+- **2026-03-24** 🏭 **FreeCAD CLI** added with 258 commands across 17 groups. **iTerm2** and **Teltonika RMS** harnesses added to registry.-- **2026-03-23** 🤖 Launched **CLI-Hub meta-skill** — agents can now discover and install CLIs autonomously via [`cli-hub-meta-skill/SKILL.md`](cli-hub-meta-skill/SKILL.md). **Krita CLI** harness merged for digital painting. DOMShell MCP parameter mismatches and connection model fixed.+- **2026-03-23** 🤖 Launched **CLI-Hub meta-skill** — agents can now discover and install CLIs autonomously. **Krita CLI** harness merged for digital painting.++</details><details>-<summary>Earlier news (Mar 17–22)</summary>+<summary>Earlier news (Mar 11–22)</summary>- **2026-03-22** 🎵 **MuseScore CLI** merged with transpose, export, and instrument management.@@ -74,12 +108,7 @@ CLI-Anything: Bridging the Gap Between AI Agents and the World's Software</stron- **2026-03-17** 🌐 Launched the **[CLI-Hub](https://hkuds.github.io/CLI-Anything/)** — a central registry where you can browse, search, and install any CLI with a single `pip` command.-</details>--<details>-<summary>Earlier news (Mar 11–16)</summary>--- **2026-03-16** 🤖 Added **SKILL.md generation** (Phase 6.5) — every generated CLI now ships with an AI-discoverable skill definition. Includes `skill_generator.py`, Jinja2 template, and 51 new tests.+- **2026-03-16** 🤖 Added **SKILL.md generation** (Phase 6.5) — every generated CLI now ships with an AI-discoverable skill definition.- **2026-03-15** 🐾 Support for **OpenClaw** from the community! Merged Windows `cygpath` guard for cross-platform support.@@ -117,7 +146,7 @@ CLI is the universal interface for both humans and AI agents:- **Python 3.10+**- Target software installed (e.g., GIMP, Blender, LibreOffice, or your own application)-- A supported AI coding agent: [Claude Code](#-claude-code) | [OpenClaw](#-openclaw) | [OpenCode](#-opencode) | [Codex](#-codex) | [Qodercli](#-qodercli) | [GitHub Copilot CLI](#-github-copilot-cli) | [More Platforms](#-more-platforms-coming-soon)+- A supported AI coding agent: [Claude Code](#-claude-code) | [Pi](#-pi-coding-agent) | [OpenClaw](#-openclaw) | [OpenCode](#-opencode) | [Codex](#-codex) | [Qodercli](#-qodercli) | [GitHub Copilot CLI](#-github-copilot-cli) | [More Platforms](#-more-platforms-coming-soon)### Pick Your Platform@@ -148,13 +177,13 @@ That's it. The plugin is now available in your Claude Code session.**Step 3: Build a CLI in One Command**```bash-# /cli-anything:cli-anything <software-path-or-repo>+# /cli-anything <software-path-or-repo># Generate a complete CLI for GIMP (all 7 phases)-/cli-anything:cli-anything ./gimp--# Note: If your Claude Code is under 2.x, use "/cli-anything" instead.+/cli-anything ./gimp```+Older Claude Code 2.x releases also accepted `/cli-anything:cli-anything`; auxiliary commands still use the `:subcommand` form (e.g. `/cli-anything:refine`).+This runs the full pipeline:1. 🔍 **Analyze** — Scans source code, maps GUI actions to APIs2. 📐 **Design** — Architects command groups, state model, output formats@@ -198,6 +227,64 @@ cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything</details>+<details>+<summary><h4 id="-pi-coding-agent">⚡ Pi Coding Agent</h4></summary>++**Step 1: Install the Extension**++The extension lives at `.pi-extension/cli-anything/` in this repository. Install it globally so `/cli-anything` commands are available in **all** Pi projects:++```bash+# Clone the repo+git clone https://github.com/HKUDS/CLI-Anything.git+cd CLI-Anything++# Install globally into Pi's extensions directory+bash .pi-extension/cli-anything/install.sh+```++To uninstall:++```bash+bash .pi-extension/cli-anything/install.sh --uninstall+```++> **How it works:** `install.sh` copies the extension files (including HARNESS.md, commands, guides, scripts, and templates from `cli-anything-plugin/`) into `~/.pi/agent/extensions/cli-anything/`, which Pi auto-discovers on startup. Run `/reload` in Pi or restart Pi to activate.++**Step 2: Build a CLI in One Command**++Once the extension is loaded, the following commands are available:++```bash+# Generate a complete CLI for GIMP (all 7 phases)+/cli-anything ./gimp++# Build from a GitHub repo+/cli-anything https://github.com/blender/blender+```++**Step 3 (Optional): Refine and Improve the CLI**++```bash+# Broad refinement — agent analyzes gaps across all capabilities+/cli-anything:refine ./gimp++# Focused refinement — target a specific functionality area+/cli-anything:refine ./gimp "batch processing and filters"+```++**Available Commands**++| Command | Description |+|---------|-------------|+| `/cli-anything <path-or-repo>` | Build a complete CLI harness |+| `/cli-anything:refine <path> [focus]` | Refine an existing CLI harness |+| `/cli-anything:test <path-or-repo>` | Run tests for a CLI harness |+| `/cli-anything:validate <path-or-repo>` | Validate a CLI harness |+| `/cli-anything:list [options]` | List all CLI-Anything tools |++</details>+<details><summary><h4 id="-opencode">⚡ OpenCode (Experimental)</h4></summary>@@ -264,7 +351,7 @@ Configure Goose to use a CLI provider such as Claude Code, and make sure that CLOnce Goose is configured, start a session and use the same CLI-Anything commands described above for Claude Code, for example:```bash-/cli-anything:cli-anything ./gimp+/cli-anything ./gimp/cli-anything:refine ./gimp "batch processing and filters"```@@ -287,7 +374,7 @@ This registers the cli-anything plugin in `~/.qoder.json`. Start a new Qodercli**Step 2: Use CLI-Anything from Qodercli**```bash-/cli-anything:cli-anything ./gimp+/cli-anything ./gimp/cli-anything:refine ./gimp "batch processing and filters"/cli-anything:validate ./gimp```@@ -377,7 +464,7 @@ This installs the CLI-Anything plugin to GitHub Copilot CLI. The plugin should n**Step 2: Use CLI-Anything from GitHub Copilot CLI**```bash-/cli-anything:cli-anything ./gimp+/cli-anything ./gimp/cli-anything:refine ./gimp "batch processing and filters"/cli-anything:validate ./gimp```@@ -443,7 +530,7 @@ The agent will browse the catalog, install whichever CLI fits the task, and use**How it works under the hood:**-1. The meta-skill points to the live catalog at [`https://hkuds.github.io/CLI-Anything/SKILL.txt`](https://hkuds.github.io/CLI-Anything/SKILL.txt)+1. The meta-skill points to the live catalog at [`https://reeceyang.sgp1.cdn.digitaloceanspaces.com/SKILL.md`](https://reeceyang.sgp1.cdn.digitaloceanspaces.com/SKILL.md)2. The agent reads 20+ CLIs organized by category with one-line `pip install` commands3. The agent installs whichever CLI fits the task, then reads that CLI's own SKILL.md for detailed usage@@ -471,14 +558,17 @@ The catalog auto-updates whenever `registry.json` changes — new community CLIs| **🤖 AI/ML Platforms** | Automate model training, inference pipelines, and hyperparameter tuning through structured commands | Stable Diffusion WebUI, ComfyUI, Ollama, InvokeAI, Text-generation-webui, Open WebUI, Fooocus, Kohya_ss, AnythingLLM, SillyTavern || **📊 Data & Analytics** | Enable programmatic data processing, visualization, and statistical analysis workflows | JupyterLab, Apache Superset, Metabase, Redash, DBeaver, KNIME, Orange, OpenSearch Dashboards, Lightdash || **💻 Development Tools** | Streamline code editing, building, testing, and deployment processes via command interfaces | Jenkins, Gitea, Hoppscotch, Portainer, pgAdmin, SonarQube, ArgoCD, OpenLens, Insomnia, Beekeeper Studio, **[iTerm2](https://iterm2.com)** |-| **🎨 Creative & Media** | Control content creation, editing, and rendering workflows programmatically | Blender, GIMP, OBS Studio, Audacity, Krita, Kdenlive, Shotcut, Inkscape, Darktable, LMMS, Ardour, VideoCaptioner |+| **🎨 Creative & Media** | Control content creation, editing, and rendering workflows programmatically | Blender, GIMP, OBS Studio, Audacity, Krita, Kdenlive, Shotcut, Inkscape, Darktable, LMMS, Ardour |+| **🎮 Game Development** | Manage game projects, scenes, exports, and scripting through headless engine interfaces | **[Godot Engine](https://godotengine.org)** || **🔬 Scientific Computing** | Automate research workflows, simulations, and complex calculations | ImageJ, FreeCAD, QGIS, ParaView, Gephi, LibreCAD, Stellarium, KiCad, JASP, Jamovi || **🏢 Enterprise & Office** | Convert business applications and productivity tools into agent-accessible systems | NextCloud, GitLab, Grafana, Mattermost, LibreOffice, AppFlowy, NocoDB, Odoo (Community), Plane, ERPNext || **📞 Communication & Collaboration** | Automate meeting scheduling, participant management, recording retrieval, and reporting through structured CLI | Zoom, Jitsi Meet, BigBlueButton, Mattermost || **📐 Diagramming & Visualization** | Create and manipulate diagrams, flowcharts, architecture diagrams, and visual documentation programmatically | Draw.io (diagrams.net), Mermaid, PlantUML, Excalidraw, yEd || **🌐 Network & Infrastructure** | Manage network services, DNS, ad-blocking, and infrastructure through structured CLI commands | AdGuardHome |+| **🧪 Testing & Mocking** | Control HTTP mock servers, manage test stubs, record and replay API traffic for integration testing | **[WireMock](https://wiremock.org)** || **🔬 Graphics & GPU Debugging** | Analyze GPU frame captures, inspect pipeline state, export shaders, and diff rendering state | RenderDoc || **🎬 Video & Subtitles** | Transcribe speech, translate subtitles, burn styled captions into video — full captioning pipeline | VideoCaptioner |+| **🔍 AI-Native Search** | Neural and deep web search with structured content retrieval through embedding-based APIs | [Exa](https://exa.ai) || **✨ AI Content Generation** | Generate professional deliverables (slides, docs, diagrams, websites, research reports) through AI-powered cloud APIs | [AnyGen](https://www.anygen.io), Gamma, Beautiful.ai, Tome |---@@ -714,6 +804,13 @@ Each application received complete, production-ready CLI interfaces — not demo<td align="center">✅ 158</td></tr><tr>+<td align="center"><strong>⚡ <a href="n8n/agent-harness/">n8n</a></strong></td>+<td>Workflow Automation</td>+<td><code>cli-anything-n8n</code></td>+<td>n8n REST API v1.1.1</td>+<td align="center">✅ <a href="n8n/agent-harness/">55+ cmds</a></td>+</tr>+<tr><td align="center"><strong>📚 <a href="zotero/agent-harness/">Zotero</a></strong></td><td>Reference Management</td><td><code>cli-anything-zotero</code></td>@@ -749,6 +846,13 @@ Each application received complete, production-ready CLI interfaces — not demo<td align="center">✅ 154</td></tr><tr>+<td align="center"><strong>🎬 <a href="openscreen/agent-harness/">Openscreen</a></strong></td>+<td>Screen Recording Editor</td>+<td><code>cli-anything-openscreen</code></td>+<td>ffmpeg backend</td>+<td align="center">✅ 101</td>+</tr>+<tr><td align="center"><strong>📞 Zoom</strong></td><td>Video Conferencing</td><td><code>cli-anything-zoom</code></td>@@ -770,6 +874,13 @@ Each application received complete, production-ready CLI interfaces — not demo<td align="center">✅ 138</td></tr><tr>+<td align="center"><strong>⛓️ ETH2 QuickStart</strong></td>+<td>DevOps / Ethereum</td>+<td><code>cli-anything-eth2-quickstart</code></td>+<td>eth2-quickstart shell automation + JSON health checks</td>+<td align="center">✅ 18</td>+</tr>+<tr><td align="center"><strong>🧜 Mermaid Live Editor</strong></td><td>Diagramming</td><td><code>cli-anything-mermaid</code></td>@@ -791,6 +902,13 @@ Each application received complete, production-ready CLI interfaces — not demo<td align="center">✅ 21</td></tr><tr>+<td align="center"><strong>🧩 <a href="dify-workflow/agent-harness/">Dify Workflow</a></strong></td>+<td>Dify DSL Editing</td>+<td><code>cli-anything-dify-workflow</code></td>+<td>Wrapper around the open-source dify-workflow CLI</td>+<td align="center">✅ 11</td>+</tr>+<tr><td align="center"><strong>🖼️ ComfyUI</strong></td><td>AI Image Generation</td><td><code>cli-anything-comfyui</code></td>@@ -812,6 +930,13 @@ Each application received complete, production-ready CLI interfaces — not demo<td align="center">✅ 98</td></tr><tr>+<td align="center"><strong>🧬 <a href="unimol_tools/agent-harness/">Uni-Mol Tools</a></strong></td>+<td>Molecular Property Prediction (AI4S)</td>+<td><code>cli-anything-unimol-tools</code></td>+<td>Uni-Mol molecular ML backend</td>+<td align="center">✅ 67</td>+</tr>+<tr><td align="center"><strong>🎬 <a href="videocaptioner/agent-harness/">VideoCaptioner</a></strong></td><td>AI Video Captioning</td><td><code>cli-anything-videocaptioner</code></td>@@ -826,19 +951,40 @@ Each application received complete, production-ready CLI interfaces — not demo<td align="center">✅ 19</td></tr><tr>-<td align="center"><strong>🅲🅲 CloudCompare</strong></td>-<td>3D Point Cloud & Mesh</td>-<td><code>cli-anything-cloudcompare</code></td>-<td>CloudCompare CLI (headless)</td>-<td align="center">✅ 88</td>+<td align="center"><strong>🎮 Godot Engine</strong></td>+<td>Game Development</td>+<td><code>cli-anything-godot</code></td>+<td>Godot 4.x headless subprocess</td>+<td align="center">✅ 24</td>+</tr>+<tr>+<td align="center"><strong>🔍 <a href="exa/agent-harness/">Exa</a></strong></td>+<td>AI-Native Web Search</td>+<td><code>cli-anything-exa</code></td>+<td>exa-py SDK</td>+<td align="center">✅ 40</td>+</tr>+<tr>+<td align="center"><strong>📈 <a href="unrealinsights/README.md">Unreal Insights</a></strong></td>+<td>Performance Profiling</td>+<td><code>cli-anything-unrealinsights</code></td>+<td>Unreal trace capture + engine-matched UnrealInsights export</td>+<td align="center">✅ 46</td>+</tr>+<tr>+<td align="center"><strong>☁️ <a href="cloudanalyzer/agent-harness/">CloudAnalyzer</a></strong></td>+<td>Point cloud / trajectory QA</td>+<td><code>cli-anything-cloudanalyzer</code></td>+<td>CloudAnalyzer (Python API)</td>+<td align="center">✅ 14</td></tr><tr><td align="center" colspan="4"><strong>Total</strong></td>-<td align="center"><strong>✅ 2,005</strong></td>+<td align="center"><strong>✅ 2,176</strong></td></tr></table>-> **100% pass rate** across all 2,005 tests — 1,453 unit tests + 533 end-to-end tests + 19 Node.js tests.+> **100% pass rate** across all 2,176 tests — 1,597 unit tests + 560 end-to-end tests + 19 Node.js tests.---@@ -866,6 +1012,7 @@ kdenlive 155 passed ✅ (111 unit + 44 e2e)shotcut 154 passed ✅ (110 unit + 44 e2e)zoom 22 passed ✅ (22 unit + 0 e2e)drawio 138 passed ✅ (116 unit + 22 e2e)+eth2-quickstart 18 passed ✅ (18 unit + 3 e2e skipped)mermaid 10 passed ✅ (5 unit + 5 e2e)anygen 50 passed ✅ (40 unit + 10 e2e)notebooklm 21 passed ✅ (21 unit + 0 e2e)@@ -875,8 +1022,11 @@ ollama 98 passed ✅ (87 unit + 11 e2e)sketch 19 passed ✅ (19 jest, Node.js)renderdoc 59 passed ✅ (45 unit + 14 e2e)cloudcompare 88 passed ✅ (49 unit + 39 e2e)+openscreen 101 passed ✅ (78 unit + 23 e2e)+unrealinsights 46 passed ✅ (46 unit + 0 e2e smoke-gated)+cloudanalyzer 14 passed ✅ (7 unit + 7 e2e)──────────────────────────────────────────────────────────────────────────────-TOTAL 2,005 passed ✅ 100% pass rate+TOTAL 2,166 passed ✅ 100% pass rate```---@@ -939,16 +1089,25 @@ cli-anything/├── 📞 zoom/agent-harness/ # Zoom CLI (22 tests)├── 🎵 musescore/agent-harness/ # MuseScore CLI (56 tests)├── 📐 drawio/agent-harness/ # Draw.io CLI (138 tests)+├── ⛓️ eth2-quickstart/agent-harness/ # ETH2 QuickStart CLI (18 unit, 3 e2e skipped)├── 🧜 mermaid/agent-harness/ # Mermaid Live Editor CLI (10 tests)├── ✨ anygen/agent-harness/ # AnyGen CLI (50 tests)├── 🖼️ comfyui/agent-harness/ # ComfyUI CLI (70 tests)├── 🧠 notebooklm/agent-harness/ # NotebookLM CLI (experimental, 21 tests)+├── 🧩 dify-workflow/agent-harness/ # Dify Workflow CLI wrapper (11 tests)├── 🛡️ adguardhome/agent-harness/ # AdGuard Home CLI (36 tests)├── 🦙 ollama/agent-harness/ # Ollama CLI (98 tests)+├── 🎮 godot/agent-harness/ # Godot Engine CLI (24 tests)├── 🎨 sketch/agent-harness/ # Sketch CLI (19 tests, Node.js)├── 🔬 renderdoc/agent-harness/ # RenderDoc CLI (59 tests)-└── 🎬 videocaptioner/agent-harness/ # VideoCaptioner CLI (26 tests)-└── ☁️ cloudcompare/agent-harness/ # CloudCompare CLI (88 tests)+├── 📈 unrealinsights/README.md # Unreal Insights human guide (English)+├── 📈 unrealinsights/README_CN.md # Unreal Insights human guide (Chinese)+├── 📈 unrealinsights/agent-harness/ # Unreal Insights CLI (46 tests)+├── 🎬 videocaptioner/agent-harness/ # VideoCaptioner CLI (26 tests)+├── 🎬 openscreen/agent-harness/ # Openscreen CLI — screen recording editor (101 tests)+├── ☁️ cloudcompare/agent-harness/ # CloudCompare CLI (88 tests)+├── 🔍 exa/agent-harness/ # Exa CLI (40 tests)+└── ⛅ cloudanalyzer/agent-harness/ # CloudAnalyzer CLI (14 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/README_CN.md b/README_CN.mdindex 36b61a8a4..b14f13116 100644--- a/README_CN.md+++ b/README_CN.md@@ -553,6 +553,13 @@ CLI-Anything 适用于任何有代码库的软件 —— 不限领域,不限<td align="center">✅ 154</td></tr><tr>+<td align="center"><strong>🎬 <a href="openscreen/agent-harness/">Openscreen</a></strong></td>+<td>屏幕录像编辑器</td>+<td><code>cli-anything-openscreen</code></td>+<td>ffmpeg backend</td>+<td align="center">✅ 101</td>+</tr>+<tr><td align="center"><strong>📞 Zoom</strong></td><td>视频会议</td><td><code>cli-anything-zoom</code></td>@@ -574,6 +581,13 @@ CLI-Anything 适用于任何有代码库的软件 —— 不限领域,不限<td align="center">✅ 50</td></tr><tr>+<td align="center"><strong>📈 <a href="unrealinsights/README_CN.md">Unreal Insights</a></strong></td>+<td>性能分析</td>+<td><code>cli-anything-unrealinsights</code></td>+<td>Unreal trace 采集 + 匹配版 UnrealInsights 导出</td>+<td align="center">✅ 46</td>+</tr>+<tr><td align="center"><strong>🎨 Sketch</strong></td><td>UI 设计</td><td><code>sketch-cli</code></td>@@ -582,11 +596,11 @@ CLI-Anything 适用于任何有代码库的软件 —— 不限领域,不限</tr><tr><td align="center" colspan="4"><strong>合计</strong></td>-<td align="center"><strong>✅ 1,527</strong></td>+<td align="center"><strong>✅ 1,573</strong></td></tr></table>-> 全部 1,527 项测试 **100% 通过** —— 1,073 项单元测试 + 435 项端到端测试 + 19 项 Node.js 测试。+> 全部 1,674 项测试 **100% 通过** —— 1,197 项单元测试 + 458 项端到端测试 + 19 项 Node.js 测试。---@@ -611,12 +625,14 @@ libreoffice 158 passed ✅ (89 unit + 69 e2e)obs-studio 153 passed ✅ (116 unit + 37 e2e)kdenlive 155 passed ✅ (111 unit + 44 e2e)shotcut 154 passed ✅ (110 unit + 44 e2e)+openscreen 101 passed ✅ (78 unit + 23 e2e)zoom 22 passed ✅ (22 unit + 0 e2e)drawio 138 passed ✅ (116 unit + 22 e2e)anygen 50 passed ✅ (40 unit + 10 e2e)+unrealinsights 46 passed ✅ (46 unit + 0 e2e smoke-gated)sketch 19 passed ✅ (19 jest, Node.js)──────────────────────────────────────────────────────────────────────────────-TOTAL 1,527 passed ✅ 100% pass rate+TOTAL 1,674 passed ✅ 100% pass rate```---@@ -679,9 +695,13 @@ cli-anything/├── 📹 obs-studio/agent-harness/ # OBS Studio CLI(153 项测试)├── 🎞️ kdenlive/agent-harness/ # Kdenlive CLI(155 项测试)├── 🎬 shotcut/agent-harness/ # Shotcut CLI(154 项测试)+├── 🎬 openscreen/agent-harness/ # Openscreen CLI — 屏幕录像编辑器(101 项测试)├── 📞 zoom/agent-harness/ # Zoom CLI(22 项测试)├── 📐 drawio/agent-harness/ # Draw.io CLI(138 项测试)├── ✨ anygen/agent-harness/ # AnyGen CLI(50 项测试)+├── 📈 unrealinsights/README.md # Unreal Insights 人类说明(英文)+├── 📈 unrealinsights/README_CN.md # Unreal Insights 人类说明(中文)+├── 📈 unrealinsights/agent-harness/ # Unreal Insights CLI(46 项测试)└── 🎨 sketch/agent-harness/ # Sketch CLI(19 项测试,Node.js)```diff --git a/registry.json b/registry.jsonindex 08812d9b5..58018a97c 100644--- a/registry.json+++ b/registry.json@@ -2,9 +2,28 @@"meta": {"repo": "https://github.com/HKUDS/CLI-Anything","description": "CLI-Hub — Agent-native stateful CLI interfaces for softwares, codebases, and Web Services",- "updated": "2026-04-15"+ "updated": "2026-04-16"},"clis": [+ {+ "name": "wiremock",+ "display_name": "WireMock",+ "version": "0.1.0",+ "description": "HTTP mock server management — create stubs, inspect requests, record traffic, and manage scenarios via WireMock REST API",+ "requires": "WireMock server running (java -jar wiremock-standalone.jar)",+ "homepage": "https://wiremock.org",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=wiremock/agent-harness",+ "entry_point": "cli-anything-wiremock",+ "skill_md": "wiremock/agent-harness/cli_anything/wiremock/skills/SKILL.md",+ "category": "testing",+ "contributors": [+ {+ "name": "fabiomantel",+ "url": "https://github.com/fabiomantel"+ }+ ]+ },{"name": "anygen","display_name": "AnyGen",@@ -12,12 +31,17 @@"description": "Generate docs, slides, websites and more via AnyGen cloud API","requires": "ANYGEN_API_KEY","homepage": "https://anygen.com",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=anygen/agent-harness","entry_point": "cli-anything-anygen","skill_md": "anygen/agent-harness/cli_anything/anygen/skills/SKILL.md","category": "generation",- "contributor": "koltyu-anygen",- "contributor_url": "https://github.com/koltyu-anygen"+ "contributors": [+ {+ "name": "koltyu-anygen",+ "url": "https://github.com/koltyu-anygen"+ }+ ]},{"name": "adguardhome",@@ -26,12 +50,17 @@"description": "DNS ad-blocking and network infrastructure management via AdGuardHome REST API","requires": "AdGuardHome instance running","homepage": "https://adguard.com/adguard-home/overview.html",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=adguardhome/agent-harness","entry_point": "cli-anything-adguardhome","skill_md": null,"category": "network",- "contributor": "pyxl-dev",- "contributor_url": "https://github.com/pyxl-dev"+ "contributors": [+ {+ "name": "pyxl-dev",+ "url": "https://github.com/pyxl-dev"+ }+ ]},{"name": "audacity",@@ -40,12 +69,17 @@"description": "Audio editing and processing via sox","requires": "sox (apt install sox)","homepage": "https://www.audacityteam.org",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=audacity/agent-harness","entry_point": "cli-anything-audacity","skill_md": "audacity/agent-harness/cli_anything/audacity/skills/SKILL.md","category": "audio",- "contributor": "CLI-Anything-Team",- "contributor_url": "https://github.com/HKUDS/CLI-Anything"+ "contributors": [+ {+ "name": "CLI-Anything-Team",+ "url": "https://github.com/HKUDS/CLI-Anything"+ }+ ]},{"name": "blender",@@ -54,12 +88,17 @@"description": "3D modeling, animation, and rendering via blender --background --python","requires": "blender >= 4.2","homepage": "https://www.blender.org",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=blender/agent-harness","entry_point": "cli-anything-blender","skill_md": "blender/agent-harness/cli_anything/blender/skills/SKILL.md","category": "3d",- "contributor": "CLI-Anything-Team",- "contributor_url": "https://github.com/HKUDS/CLI-Anything"+ "contributors": [+ {+ "name": "CLI-Anything-Team",+ "url": "https://github.com/HKUDS/CLI-Anything"+ }+ ]},{"name": "browser",@@ -68,12 +107,17 @@"description": "Browser automation via DOMShell MCP server. Maps Chrome's Accessibility Tree to a virtual filesystem for agent-native navigation.","requires": "Node.js, npx, Chrome + DOMShell extension","homepage": "https://github.com/apireno/DOMShell",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=browser/agent-harness","entry_point": "cli-anything-browser","skill_md": "browser/agent-harness/cli_anything/browser/skills/SKILL.md","category": "web",- "contributor": "furkankoykiran",- "contributor_url": "https://github.com/furkankoykiran"+ "contributors": [+ {+ "name": "furkankoykiran",+ "url": "https://github.com/furkankoykiran"+ }+ ]},{"name": "comfyui",@@ -82,12 +126,17 @@"description": "AI image generation workflow management via ComfyUI REST API","requires": "ComfyUI running at http://localhost:8188","homepage": "https://github.com/comfyanonymous/ComfyUI",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=comfyui/agent-harness","entry_point": "cli-anything-comfyui","skill_md": null,"category": "ai",- "contributor": "Bortlesboat",- "contributor_url": "https://github.com/Bortlesboat"+ "contributors": [+ {+ "name": "Bortlesboat",+ "url": "https://github.com/Bortlesboat"+ }+ ]},{"name": "drawio",@@ -96,12 +145,36 @@"description": "Diagram creation and export via draw.io CLI","requires": "draw.io desktop app","homepage": "https://www.drawio.com",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=drawio/agent-harness","entry_point": "cli-anything-drawio","skill_md": "drawio/agent-harness/cli_anything/drawio/skills/SKILL.md","category": "diagrams",- "contributor": "zhangxilong-43",- "contributor_url": "https://github.com/zhangxilong-43"+ "contributors": [+ {+ "name": "zhangxilong-43",+ "url": "https://github.com/zhangxilong-43"+ }+ ]+ },+ {+ "name": "eth2-quickstart",+ "display_name": "ETH2 QuickStart",+ "version": "1.0.0",+ "description": "Hardened Ethereum node deployment and operations via the eth2-quickstart automation scripts",+ "requires": "local eth2-quickstart checkout with scripts/eth2qs.sh; Linux host required for real install workflows",+ "homepage": "https://github.com/chimera-defi/eth2-quickstart",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=eth2-quickstart/agent-harness",+ "entry_point": "cli-anything-eth2-quickstart",+ "skill_md": "eth2-quickstart/agent-harness/cli_anything/eth2_quickstart/skills/SKILL.md",+ "category": "devops",+ "contributors": [+ {+ "name": "chimera-defi",+ "url": "https://github.com/chimera-defi"+ }+ ]},{"name": "gimp",@@ -110,12 +183,17 @@"description": "Raster image processing via gimp -i -b (batch mode)","requires": "gimp (apt install gimp)","homepage": "https://www.gimp.org",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=gimp/agent-harness","entry_point": "cli-anything-gimp","skill_md": "gimp/agent-harness/cli_anything/gimp/skills/SKILL.md","category": "image",- "contributor": "CLI-Anything-Team",- "contributor_url": "https://github.com/HKUDS/CLI-Anything"+ "contributors": [+ {+ "name": "CLI-Anything-Team",+ "url": "https://github.com/HKUDS/CLI-Anything"+ }+ ]},{"name": "inkscape",@@ -124,12 +202,17 @@"description": "SVG vector graphics with export via inkscape --export-filename","requires": "inkscape (apt install inkscape)","homepage": "https://inkscape.org",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=inkscape/agent-harness","entry_point": "cli-anything-inkscape","skill_md": "inkscape/agent-harness/cli_anything/inkscape/skills/SKILL.md","category": "image",- "contributor": "CLI-Anything-Team",- "contributor_url": "https://github.com/HKUDS/CLI-Anything"+ "contributors": [+ {+ "name": "CLI-Anything-Team",+ "url": "https://github.com/HKUDS/CLI-Anything"+ }+ ]},{"name": "kdenlive",@@ -138,12 +221,17 @@"description": "Video editing and rendering via melt","requires": "melt (apt install melt)","homepage": "https://kdenlive.org",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=kdenlive/agent-harness","entry_point": "cli-anything-kdenlive","skill_md": "kdenlive/agent-harness/cli_anything/kdenlive/skills/SKILL.md","category": "video",- "contributor": "CLI-Anything-Team",- "contributor_url": "https://github.com/HKUDS/CLI-Anything"+ "contributors": [+ {+ "name": "CLI-Anything-Team",+ "url": "https://github.com/HKUDS/CLI-Anything"+ }+ ]},{"name": "krita",@@ -152,12 +240,17 @@"description": "Digital painting and raster image editing via Krita CLI export pipeline","requires": "krita (krita.org)","homepage": "https://krita.org",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=krita/agent-harness","entry_point": "cli-anything-krita","skill_md": "krita/agent-harness/cli_anything/krita/skills/SKILL.md","category": "image",- "contributor": "AlexGabbia",- "contributor_url": "https://github.com/AlexGabbia"+ "contributors": [+ {+ "name": "AlexGabbia",+ "url": "https://github.com/AlexGabbia"+ }+ ]},{"name": "libreoffice",@@ -166,26 +259,40 @@"description": "Create and manipulate ODF documents, export to PDF/DOCX/XLSX/PPTX via headless mode","requires": "libreoffice","homepage": "https://www.libreoffice.org",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=libreoffice/agent-harness","entry_point": "cli-anything-libreoffice","skill_md": "libreoffice/agent-harness/cli_anything/libreoffice/skills/SKILL.md","category": "office",- "contributor": "CLI-Anything-Team",- "contributor_url": "https://github.com/HKUDS/CLI-Anything"+ "contributors": [+ {+ "name": "CLI-Anything-Team",+ "url": "https://github.com/HKUDS/CLI-Anything"+ }+ ]},{"name": "zotero","display_name": "Zotero",- "version": "0.1.0",- "description": "Reference management via local Zotero SQLite, connector, and Local API",- "requires": "Zotero desktop app",+ "version": "0.4.1",+ "description": "CLI & MCP server for Zotero 7/8 — 52 MCP tools + 70+ CLI commands for search, import, PDF, BibTeX, notes, and more",+ "requires": "Zotero 7/8 desktop app (running), Python 3.10+","homepage": "https://www.zotero.org",- "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=zotero/agent-harness",+ "source_url": "https://github.com/PiaoyangGuohai1/cli-anything-zotero",+ "install_cmd": "pip install cli-anything-zotero","entry_point": "cli-anything-zotero",- "skill_md": "zotero/agent-harness/cli_anything/zotero/skills/SKILL.md",+ "skill_md": "https://github.com/PiaoyangGuohai1/cli-anything-zotero/blob/main/cli_anything/zotero/skills/SKILL.md","category": "office",- "contributor": "zhiwuyazhe_fjr",- "contributor_url": "https://github.com/zhiwuyazhe_fjr"+ "contributors": [+ {+ "name": "zhiwuyazhe_fjr",+ "url": "https://github.com/zhiwuyazhe-fjr"+ },+ {+ "name": "PiaoyangGuohai1",+ "url": "https://github.com/PiaoyangGuohai1"+ }+ ]},{"name": "mubu",@@ -194,12 +301,17 @@"description": "Knowledge management and outlining via local Mubu desktop data","requires": "Mubu desktop app","homepage": "https://mubu.com",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=mubu/agent-harness","entry_point": "cli-anything-mubu","skill_md": "mubu/agent-harness/cli_anything/mubu/skills/SKILL.md","category": "office",- "contributor": "cnfjlhj",- "contributor_url": "https://github.com/cnfjlhj"+ "contributors": [+ {+ "name": "cnfjlhj",+ "url": "https://github.com/cnfjlhj"+ }+ ]},{"name": "mermaid",@@ -208,12 +320,17 @@"description": "Mermaid Live Editor state files and renderer URLs","requires": null,"homepage": "https://mermaid.js.org",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=mermaid/agent-harness","entry_point": "cli-anything-mermaid","skill_md": null,"category": "diagrams",- "contributor": "getmored-create",- "contributor_url": "https://github.com/getmored-create"+ "contributors": [+ {+ "name": "getmored-create",+ "url": "https://github.com/getmored-create"+ }+ ]},{"name": "notebooklm",@@ -222,12 +339,17 @@"description": "Experimental NotebookLM harness scaffold wrapping the installed notebooklm CLI for notebook, source, chat, artifact, download, and sharing workflows","requires": "notebooklm CLI from notebooklm-py + valid local NotebookLM login session","homepage": "https://notebooklm.google.com",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=notebooklm/agent-harness","entry_point": "cli-anything-notebooklm","skill_md": "notebooklm/agent-harness/cli_anything/notebooklm/skills/SKILL.md","category": "ai",- "contributor": "Haimbeau1o",- "contributor_url": "https://github.com/Haimbeau1o"+ "contributors": [+ {+ "name": "Haimbeau1o",+ "url": "https://github.com/Haimbeau1o"+ }+ ]},{"name": "ollama",@@ -236,12 +358,17 @@"description": "Local LLM inference and model management via Ollama REST API","requires": "Ollama running at http://localhost:11434","homepage": "https://ollama.com",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=ollama/agent-harness","entry_point": "cli-anything-ollama","skill_md": "ollama/agent-harness/cli_anything/ollama/skills/SKILL.md","category": "ai",- "contributor": "CLI-Anything-Team",- "contributor_url": "https://github.com/HKUDS/CLI-Anything"+ "contributors": [+ {+ "name": "CLI-Anything-Team",+ "url": "https://github.com/HKUDS/CLI-Anything"+ }+ ]},{"name": "obs-studio",@@ -250,12 +377,17 @@"description": "Create and manage streaming/recording scenes via command line","requires": "obs-studio","homepage": "https://obsproject.com",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=obs-studio/agent-harness","entry_point": "cli-anything-obs-studio","skill_md": "obs-studio/agent-harness/cli_anything/obs_studio/skills/SKILL.md","category": "streaming",- "contributor": "CLI-Anything-Team",- "contributor_url": "https://github.com/HKUDS/CLI-Anything"+ "contributors": [+ {+ "name": "CLI-Anything-Team",+ "url": "https://github.com/HKUDS/CLI-Anything"+ }+ ]},{"name": "shotcut",@@ -264,12 +396,36 @@"description": "Video editing and rendering via melt/ffmpeg","requires": "melt (apt install melt), ffmpeg (apt install ffmpeg)","homepage": "https://shotcut.org",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=shotcut/agent-harness","entry_point": "cli-anything-shotcut","skill_md": "shotcut/agent-harness/cli_anything/shotcut/skills/SKILL.md","category": "video",- "contributor": "CLI-Anything-Team",- "contributor_url": "https://github.com/HKUDS/CLI-Anything"+ "contributors": [+ {+ "name": "CLI-Anything-Team",+ "url": "https://github.com/HKUDS/CLI-Anything"+ }+ ]+ },+ {+ "name": "openscreen",+ "display_name": "Openscreen",+ "version": "1.0.0",+ "description": "Screen recording editor — zoom, speed ramps, trim, crop, annotations, backgrounds, and polished exports via ffmpeg",+ "requires": "ffmpeg (apt install ffmpeg)",+ "homepage": "https://github.com/siddharthvaddem/openscreen",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=openscreen/agent-harness",+ "entry_point": "cli-anything-openscreen",+ "skill_md": "openscreen/agent-harness/cli_anything/openscreen/skills/SKILL.md",+ "category": "video",+ "contributors": [+ {+ "name": "ndpvt-web",+ "url": "https://github.com/ndpvt-web"+ }+ ]},{"name": "zoom",@@ -278,12 +434,17 @@"description": "Meeting management via Zoom REST API (OAuth2)","requires": "Zoom account + OAuth app credentials","homepage": "https://zoom.us",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=zoom/agent-harness","entry_point": "cli-anything-zoom","skill_md": "zoom/agent-harness/cli_anything/zoom/skills/SKILL.md","category": "communication",- "contributor": "zhangxilong-43",- "contributor_url": "https://github.com/zhangxilong-43"+ "contributors": [+ {+ "name": "zhangxilong-43",+ "url": "https://github.com/zhangxilong-43"+ }+ ]},{"name": "novita",@@ -292,12 +453,74 @@"description": "Access AI models via Novita's OpenAI-compatible API (DeepSeek, GLM, MiniMax)","requires": "NOVITA_API_KEY","homepage": "https://novita.ai",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=novita/agent-harness","entry_point": "cli-anything-novita","skill_md": "novita/agent-harness/cli_anything/novita/skills/SKILL.md","category": "ai",- "contributor": "Alex-wuhu",- "contributor_url": "https://github.com/Alex-wuhu"+ "contributors": [+ {+ "name": "Alex-wuhu",+ "url": "https://github.com/Alex-wuhu"+ }+ ]+ },+ {+ "name": "seaclip",+ "display_name": "SeaClip",+ "version": "1.0.0",+ "description": "Kanban board, 6-agent AI pipeline, and issue management via SeaClip-Lite FastAPI + SQLite",+ "requires": "SeaClip-Lite running at localhost:5200",+ "homepage": "https://github.com/t4tarzan/cli-anything-seaclip",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=seaclip/agent-harness",+ "entry_point": "cli-anything-seaclip",+ "skill_md": "seaclip/agent-harness/cli_anything/seaclip/skills/SKILL.md",+ "category": "project-management",+ "contributors": [+ {+ "name": "t4tarzan",+ "url": "https://github.com/t4tarzan"+ }+ ]+ },+ {+ "name": "pm2",+ "display_name": "PM2",+ "version": "1.0.0",+ "description": "Node.js process management — list, start, stop, restart, logs, and metrics via PM2 CLI",+ "requires": "PM2 (npm install -g pm2)",+ "homepage": "https://pm2.keymetrics.io",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=pm2/agent-harness",+ "entry_point": "cli-anything-pm2",+ "skill_md": "pm2/agent-harness/cli_anything/pm2/skills/SKILL.md",+ "category": "devops",+ "contributors": [+ {+ "name": "t4tarzan",+ "url": "https://github.com/t4tarzan"+ }+ ]+ },+ {+ "name": "chromadb",+ "display_name": "ChromaDB",+ "version": "1.0.0",+ "description": "Vector database operations — collections, documents, semantic search via ChromaDB HTTP API",+ "requires": "ChromaDB server running at localhost:8000",+ "homepage": "https://www.trychroma.com",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=chromadb/agent-harness",+ "entry_point": "cli-anything-chromadb",+ "skill_md": "chromadb/agent-harness/cli_anything/chromadb/skills/SKILL.md",+ "category": "database",+ "contributors": [+ {+ "name": "t4tarzan",+ "url": "https://github.com/t4tarzan"+ }+ ]},{"name": "musescore",@@ -306,12 +529,17 @@"description": "CLI for music notation — transpose, export PDF/audio/MIDI, extract parts, manage instruments","requires": "MuseScore 4 (musescore.org)","homepage": "https://musescore.org",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=musescore/agent-harness","entry_point": "cli-anything-musescore","skill_md": "musescore/agent-harness/cli_anything/musescore/skills/SKILL.md","category": "music",- "contributor": "tamvicky",- "contributor_url": "https://github.com/tamvicky"+ "contributors": [+ {+ "name": "tamvicky",+ "url": "https://github.com/tamvicky"+ }+ ]},{"name": "sketch",@@ -320,12 +548,17 @@"description": "Generate Sketch design files (.sketch) from JSON design specifications via sketch-constructor","requires": "Node.js >= 16.0.0","homepage": "https://www.sketch.com",+ "source_url": null,"install_cmd": "cd sketch/agent-harness && npm install && npm link","entry_point": "sketch-cli","skill_md": null,"category": "design",- "contributor": "zhangxilong-43",- "contributor_url": "https://github.com/zhangxilong-43"+ "contributors": [+ {+ "name": "zhangxilong-43",+ "url": "https://github.com/zhangxilong-43"+ }+ ]},{"name": "freecad",@@ -334,12 +567,17 @@"description": "Parametric 3D CAD modeling via FreeCAD CLI (258 commands: Part, Sketcher, PartDesign, Assembly, Mesh, TechDraw, Draft, FEM, CAM, and more)","requires": "FreeCAD >= 1.1 (freecad.org)","homepage": "https://www.freecad.org",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=freecad/agent-harness","entry_point": "cli-anything-freecad","skill_md": "freecad/agent-harness/cli_anything/freecad/skills/SKILL.md","category": "3d",- "contributor": "AlexGabbia",- "contributor_url": "https://github.com/AlexGabbia"+ "contributors": [+ {+ "name": "AlexGabbia",+ "url": "https://github.com/AlexGabbia"+ }+ ]},{"name": "iterm2",@@ -348,26 +586,36 @@"description": "Control a running iTerm2 instance — manage windows, tabs, split panes, send text, read output, run tmux -CC, broadcast keystrokes, and configure preferences.","requires": "iTerm2.app (macOS only)","homepage": "https://iterm2.com",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=iterm2/agent-harness","entry_point": "cli-anything-iterm2","skill_md": "iterm2/agent-harness/cli_anything/iterm2_ctl/skills/SKILL.md","category": "devops",- "contributor": "voidfreud",- "contributor_url": "https://github.com/voidfreud"+ "contributors": [+ {+ "name": "voidfreud",+ "url": "https://github.com/voidfreud"+ }+ ]},{"name": "slay_the_spire_ii",- "display_name": "Slay the Spire II",+ "display_name": "Slay the Spire 2","version": "1.0.0","description": "Control the real Slay the Spire 2 game via local STS2_Bridge HTTP API","requires": "Slay the Spire 2 (Steam) with STS2_Bridge mod enabled","homepage": "https://github.com/HKUDS/CLI-Anything/tree/main/slay_the_spire_ii",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=slay_the_spire_ii/agent-harness","entry_point": "cli-anything-sts2","skill_md": "slay_the_spire_ii/agent-harness/cli_anything/slay_the_spire_ii/skills/SKILL.md","category": "game",- "contributor": "TianyuFan0504",- "contributor_url": "https://github.com/TianyuFan0504"+ "contributors": [+ {+ "name": "TianyuFan0504",+ "url": "https://github.com/TianyuFan0504"+ }+ ]},{"name": "rms",@@ -376,12 +624,17 @@"description": "Device management and monitoring via Teltonika RMS REST API","requires": "RMS_API_TOKEN","homepage": "https://rms.teltonika-networks.com",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=rms/agent-harness","entry_point": "cli-anything-rms","skill_md": "rms/agent-harness/cli_anything/rms/skills/SKILL.md","category": "network",- "contributor": "galke",- "contributor_url": "https://github.com/galke7"+ "contributors": [+ {+ "name": "galke",+ "url": "https://github.com/galke7"+ }+ ]},{"name": "renderdoc",@@ -390,26 +643,36 @@"description": "GPU frame capture analysis: pipeline state, shader export, texture inspection, draw call browsing","requires": "renderdoc (Python bindings from RenderDoc installation)","homepage": "https://renderdoc.org",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=renderdoc/agent-harness","entry_point": "cli-anything-renderdoc","skill_md": "renderdoc/agent-harness/cli_anything/renderdoc/skills/SKILL.md","category": "graphics",- "contributor": "levishilf",- "contributor_url": "https://github.com/levishilf"+ "contributors": [+ {+ "name": "levishilf",+ "url": "https://github.com/levishilf"+ }+ ]},{"name": "unrealinsights","display_name": "Unreal Insights","version": "0.1.0",- "description": "Windows-first Unreal trace capture orchestration and headless Timing Insights export workflows",- "requires": "Windows + Unreal Engine 5.5+ installation with UnrealInsights.exe",+ "description": "Windows-first Unreal trace capture, background session control, engine-matched UnrealInsights builds, and headless Timing Insights export workflows",+ "requires": "Windows + Unreal Engine source or installed build with UnrealEditor and Unreal trace support","homepage": "https://dev.epicgames.com/documentation/en-us/unreal-engine/unreal-insights-in-unreal-engine",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=unrealinsights/agent-harness","entry_point": "cli-anything-unrealinsights","skill_md": "unrealinsights/agent-harness/cli_anything/unrealinsights/skills/SKILL.md","category": "debugging",- "contributor": "AiMiDi",- "contributor_url": "https://github.com/AiMiDi"+ "contributors": [+ {+ "name": "AiMiDi",+ "url": "https://github.com/AiMiDi"+ }+ ]},{"name": "videocaptioner",@@ -418,12 +681,17 @@"description": "AI-powered video captioning — transcribe speech, optimize/translate subtitles, burn styled subtitles into video","requires": "videocaptioner (pip install videocaptioner), ffmpeg","homepage": "https://github.com/WEIFENG2333/VideoCaptioner",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=videocaptioner/agent-harness","entry_point": "cli-anything-videocaptioner","skill_md": "videocaptioner/agent-harness/cli_anything/videocaptioner/skills/SKILL.md","category": "video",- "contributor": "WEIFENG2333",- "contributor_url": "https://github.com/WEIFENG2333"+ "contributors": [+ {+ "name": "WEIFENG2333",+ "url": "https://github.com/WEIFENG2333"+ }+ ]},{"name": "intelwatch",@@ -432,12 +700,17 @@"description": "Competitive intelligence, M&A due diligence, and OSINT directly from your terminal.","requires": "Node.js >=18","homepage": "https://github.com/ashroth/intelwatch",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=intelwatch/agent-harness","entry_point": "cli-anything-intelwatch","skill_md": "intelwatch/agent-harness/cli_anything/intelwatch/skills/SKILL.md","category": "osint",- "contributor": "ashroth",- "contributor_url": "https://github.com/ashroth"+ "contributors": [+ {+ "name": "ashroth",+ "url": "https://github.com/ashroth"+ }+ ]},{"name": "clibrowser",@@ -446,12 +719,17 @@"description": "Zero-dependency CLI browser for AI agents with search, extraction, forms, RSS, crawling, auth, and WebMCP support","requires": "Rust toolchain (cargo) for source install, or manual binary download from GitHub Releases","homepage": "https://github.com/allthingssecurity/clibrowser",+ "source_url": null,"install_cmd": "cargo install --git https://github.com/allthingssecurity/clibrowser.git --tag v0.1.0 --locked","entry_point": "clibrowser","skill_md": null,"category": "web",- "contributor": "allthingssecurity",- "contributor_url": "https://github.com/allthingssecurity"+ "contributors": [+ {+ "name": "allthingssecurity",+ "url": "https://github.com/allthingssecurity"+ }+ ]},{"name": "cloudcompare",@@ -460,12 +738,169 @@"description": "3D point cloud and mesh processing: load/save, color ops, normal estimation, Delaunay meshing, noise filtering, ICP registration, connected component segmentation","requires": "cloudcompare (CloudCompare application installed, e.g. via Flatpak or package manager)","homepage": "https://cloudcompare.org",+ "source_url": null,"install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=cloudcompare/agent-harness","entry_point": "cli-anything-cloudcompare","skill_md": "cloudcompare/agent-harness/cli_anything/cloudcompare/skills/SKILL.md","category": "graphics",- "contributor": "Taeyoung96",- "contributor_url": "https://github.com/Taeyoung96"+ "contributors": [+ {+ "name": "Taeyoung96",+ "url": "https://github.com/Taeyoung96"+ }+ ]+ },+ {+ "name": "exa",+ "display_name": "Exa",+ "version": "1.0.0",+ "description": "AI-powered web search and content extraction via the Exa API",+ "requires": "EXA_API_KEY (free tier at exa.ai)",+ "homepage": "https://exa.ai",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=exa/agent-harness",+ "entry_point": "cli-anything-exa",+ "skill_md": "exa/agent-harness/cli_anything/exa/skills/SKILL.md",+ "category": "search",+ "contributors": [+ {+ "name": "tgonzalezc5",+ "url": "https://github.com/tgonzalezc5"+ }+ ]+ },+ {+ "name": "godot",+ "display_name": "Godot Engine",+ "version": "1.0.0",+ "description": "Game engine project management, scene editing, export and GDScript execution via Godot 4 headless mode",+ "requires": "Godot 4.x (godotengine.org)",+ "homepage": "https://godotengine.org",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=godot/agent-harness",+ "entry_point": "cli-anything-godot",+ "skill_md": "godot/agent-harness/cli_anything/godot/skills/SKILL.md",+ "category": "gamedev",+ "contributors": [+ {+ "name": "omerarslan0",+ "url": "https://github.com/omerarslan0"+ }+ ]+ },+ {+ "name": "dify-workflow",+ "display_name": "Dify Workflow",+ "version": "0.1.0",+ "description": "CLI-Anything wrapper for the Dify workflow DSL editor covering create, inspect, validate, edit, export, and layout operations",+ "requires": "Upstream dify-workflow CLI installed from https://github.com/Akabane71/dify-workflow-cli",+ "homepage": "https://github.com/Akabane71/dify-workflow-cli",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=dify-workflow/agent-harness",+ "entry_point": "cli-anything-dify-workflow",+ "skill_md": "dify-workflow/agent-harness/cli_anything/dify_workflow/skills/SKILL.md",+ "category": "ai",+ "contributors": [+ {+ "name": "Akabane71",+ "url": "https://github.com/Akabane71"+ }+ ]+ },+ {+ "name": "n8n",+ "display_name": "n8n",+ "version": "2.4.7",+ "description": "Workflow automation via n8n REST API — 55+ commands",+ "requires": "n8n >= 1.0.0",+ "homepage": "https://n8n.io",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=n8n/agent-harness",+ "entry_point": "cli-anything-n8n",+ "skill_md": "n8n/agent-harness/cli_anything/n8n/skills/SKILL.md",+ "category": "automation",+ "contributors": [+ {+ "name": "webcomunicasolutions",+ "url": "https://github.com/webcomunicasolutions"+ }+ ]+ },+ {+ "name": "cloudanalyzer",+ "display_name": "CloudAnalyzer",+ "version": "1.0.0",+ "description": "Point cloud and trajectory QA: Chamfer/AUC/F1, ATE/RPE/drift, ground segmentation metrics, config-driven quality gates, baseline evolution — harness wraps the CloudAnalyzer Python API",+ "requires": "Python 3.10+; cloudanalyzer (`pip install cloudanalyzer`), Open3D for full IO/viewer paths",+ "homepage": "https://github.com/rsasaki0109/CloudAnalyzer",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=cloudanalyzer/agent-harness",+ "entry_point": "cli-anything-cloudanalyzer",+ "skill_md": "cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/skills/SKILL.md",+ "category": "graphics",+ "contributors": [+ {+ "name": "rsasaki0109",+ "url": "https://github.com/rsasaki0109"+ }+ ]+ },+ {+ "name": "obsidian",+ "display_name": "Obsidian",+ "version": "1.0.0",+ "description": "Knowledge management and note-taking — manage notes, search vault, execute commands via Obsidian Local REST API",+ "requires": "Obsidian desktop app with Local REST API plugin enabled",+ "homepage": "https://obsidian.md",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=obsidian/agent-harness",+ "entry_point": "cli-anything-obsidian",+ "skill_md": "obsidian/agent-harness/cli_anything/obsidian/skills/SKILL.md",+ "category": "knowledge",+ "contributors": [+ {+ "name": "dorukozgen",+ "url": "https://github.com/dorukozgen"+ }+ ]+ },+ {+ "name": "unimol_tools",+ "display_name": "Uni-Mol Tools",+ "version": "1.0.0",+ "description": "Molecular property prediction — train and predict with 5 task types (classification, regression, multiclass, multilabel) for drug discovery",+ "requires": "PyTorch 1.12+, Uni-Mol Tools backend",+ "homepage": "https://github.com/dptech-corp/Uni-Mol/tree/main/unimol_tools",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=unimol_tools/agent-harness",+ "entry_point": "cli-anything-unimol-tools",+ "skill_md": "unimol_tools/agent-harness/cli_anything/unimol_tools/SKILL.md",+ "category": "science",+ "contributors": [+ {+ "name": "545487677",+ "url": "https://github.com/545487677"+ }+ ]+ },+ {+ "name": "safari",+ "display_name": "Safari",+ "version": "1.0.0",+ "description": "Native macOS Safari browser automation via safari-mcp — 84 tools for navigation, DOM, forms, network capture, and screenshots",+ "requires": "macOS, Safari, safari-mcp (npm install -g safari-mcp)",+ "homepage": "https://github.com/achiya-automation/safari-mcp",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=safari/agent-harness",+ "entry_point": "cli-anything-safari",+ "skill_md": "safari/agent-harness/cli_anything/safari/skills/SKILL.md",+ "category": "web",+ "contributors": [+ {+ "name": "achiya-automation",+ "url": "https://github.com/achiya-automation"+ }+ ]}]}diff --git a/unrealinsights/README.md b/unrealinsights/README.mdnew file mode 100644index 000000000..5764913da--- /dev/null+++ b/unrealinsights/README.md@@ -0,0 +1,127 @@+# Unreal Insights Human Guide++This document is for people collaborating with AI, not for Python package maintainers.++`unrealinsights/agent-harness` gives AI agents a reliable way to drive Unreal+trace capture and Unreal Insights analysis workflows from the terminal.++## What This Capability Can Do++- find or build an `UnrealInsights.exe` matching your current Unreal Engine+- start a one-shot trace capture+- start a background capture and let it run until you decide to stop+- inspect the current background capture status+- create a best-effort snapshot copy of the active trace+- stop the tracked capture session+- export an existing `.utrace` into:+ - `threads`+ - `timers`+ - `timing-events`+ - `timer-stats`+ - `timer-callees`+ - `counters`+ - `counter-values`+- read exported CSV files and summarize hotspots, waits, and likely bottlenecks++## How Humans Should Ask AI To Use It++The most effective prompt is not “analyze performance,” but a prompt that gives:++1. engine path+2. project path or target executable+3. whether you care about startup or runtime behavior+4. what output you want back++## Good Prompt Patterns++### Startup performance++```text+Use D:\code\D5\d5render-ue5_3 to analyze startup performance for+D:\code\D5\FusionEffectBuild.+First ensure a matching UnrealInsights.exe exists, then capture a startup trace,+export timer-stats, and summarize the top 20 hotspots.+```++### Long-running capture until I say stop++```text+Use D:\code\D5\d5render-ue5_3 and D:\code\D5\FusionEffectBuild+to start a background performance capture.+Do not block and do not exit the project immediately.+Tell me the trace path and current status first.+When I say "stop", stop the capture, make a snapshot, export timer-stats and+timing-events, then summarize the results.+```++### Runtime scene analysis++```text+Start a background trace for this project, let me interact with the scene+manually, and wait.+When I say "stop now", export timer-stats and timing-events and focus on+GameThread, RenderThread, and task-system waits.+```++### Source-built engine without UnrealInsights.exe++```text+This is a source-built engine.+First find or build UnrealInsights.exe under D:\code\D5\d5render-ue5_3,+then use it to analyze the trace.+```++## Keywords AI Handles Well++These phrases are especially useful:++- “ensure matching UnrealInsights”+- “background continuous capture”+- “wait until I say stop”+- “make a snapshot”+- “export timer-stats”+- “export timing-events”+- “summarize top hotspots”+- “look at GameThread / RenderThread / WaitForTasks”++## What AI Can Usually Do Automatically++If you give enough context, AI can usually:++- resolve the `.uproject`+- infer `UnrealEditor.exe`+- choose or build a matching `UnrealInsights.exe`+- generate `.utrace`+- export CSV reports+- extract hotspots from CSV+- tell you whether the trace looks more like:+ - startup waiting+ - task-scheduler blocking+ - GameThread stalls+ - RenderThread / render-pass pressure+ - audio or streaming side effects++## Current Scope++The current version supports:++- `capture run`+- `capture start`+- `capture status`+- `capture stop`+- `capture snapshot`+- `backend ensure-insights`++It is not full Unreal GUI automation:++- it does not drive an already-open Unreal Insights GUI panel directly+- it does not fully manage live SessionFrontend / TraceStore UI workflows+- `capture stop` is a best-effort stop of the harness-launched process tree, not+ full SessionServices remote `Trace.Stop`+- `capture snapshot` is a best-effort filesystem snapshot of the active trace,+ not a full live trace-store control path++## One-Sentence Rule++Give AI the path, the scene, the timing, and the desired output, and it will be+able to use this capability much more effectively.diff --git a/unrealinsights/README_CN.md b/unrealinsights/README_CN.mdnew file mode 100644index 000000000..0fa3c3cb5--- /dev/null+++ b/unrealinsights/README_CN.md@@ -0,0 +1,121 @@+# Unreal Insights 使用说明++这份文档是给正在和 AI 协作的人看的,不是给 Python 包维护者看的。++`unrealinsights/agent-harness` 提供的是一套 AI 可调用的 Unreal 性能采集与分析能力,让 Agent 能比较稳定地驱动 Unreal trace capture 和 Unreal Insights 导出流程。++## 这个能力能做什么++- 找到或构建与你当前 Unreal Engine 匹配的 `UnrealInsights.exe`+- 启动一次性 trace 采集+- 启动后台持续采集,并在你指定时机停止+- 查看当前后台采集状态+- 对当前活跃 trace 做 best-effort 快照+- 停止当前追踪会话+- 对已有 `.utrace` 导出:+ - `threads`+ - `timers`+ - `timing-events`+ - `timer-stats`+ - `timer-callees`+ - `counters`+ - `counter-values`+- 读取导出的 CSV,并总结热点、等待链和可能瓶颈++## 人类应该怎么调 AI++最有效的方式不是说“帮我分析性能”,而是补齐下面四类信息:++1. 引擎路径+2. 项目路径或目标可执行文件+3. 你关心的是“启动阶段”还是“运行时场景”+4. 你希望 AI 最终给你什么输出++## 推荐提法++### 只分析启动性能++```text+用 D:\code\D5\d5render-ue5_3 这套引擎,+分析 D:\code\D5\FusionEffectBuild 这个项目的启动性能。+先确保匹配版 UnrealInsights 可用,再抓一份启动 trace,+导出 timer-stats,并总结前 20 个热点。+```++### 持续采集,等我说停++```text+用 D:\code\D5\d5render-ue5_3 和 D:\code\D5\FusionEffectBuild+启动一份后台性能采集,不要阻塞,不要立刻退出项目。+先告诉我 trace 输出路径和当前状态。+等我说“停”时,再停止采集、做一次 snapshot,+导出 timer-stats 和 timing-events。+```++### 指定场景分析运行时性能++```text+先启动后台 trace,让我在项目里手动操作某个场景。+我说“现在停”之后,你帮我导出 timer-stats、timing-events,+重点看 GameThread、RenderThread 和任务系统等待时间。+```++### 自定义引擎没有 Insights 可执行文件++```text+这套引擎是源码版,+先帮我在 D:\code\D5\d5render-ue5_3 下面找或构建 UnrealInsights.exe,+然后再用它分析 trace。+```++## AI 最容易接住的关键词++下面这些关键词很适合直接写进需求:++- “确保匹配版 UnrealInsights”+- “后台持续采集”+- “等我说停”+- “做一次 snapshot”+- “导出 timer-stats”+- “导出 timing-events”+- “总结 top hotspots”+- “看 GameThread / RenderThread / WaitForTasks”++## 你可以期待 AI 自动做的事++如果描述足够完整,AI 通常会自动:++- 解析 `.uproject`+- 推导 `UnrealEditor.exe`+- 选择或构建匹配版 `UnrealInsights.exe`+- 生成 `.utrace`+- 导出 CSV+- 从 CSV 中提取热点+- 告诉你这份 trace 更像是:+ - 启动等待+ - 任务调度阻塞+ - GameThread 卡住+ - RenderThread / 渲染 pass 偏重+ - 音频或 streaming 相关问题++## 当前能力边界++当前版本已经支持:++- `capture run`+- `capture start`+- `capture status`+- `capture stop`+- `capture snapshot`+- `backend ensure-insights`++但它还不是完整的 Unreal GUI 自动化:++- 不直接驱动已经打开的 Unreal Insights 图形界面+- 不完整覆盖 live SessionFrontend / TraceStore 的 GUI 工作流+- `capture stop` 当前是对 harness 启动的进程树做 best-effort 停止,不是完整的 SessionServices 远程 `Trace.Stop`+- `capture snapshot` 当前是对活跃 trace 的 best-effort 文件快照,不是完整的 live trace-store 控制路径++## 一句话原则++把“路径 + 场景 + 时机 + 输出物”说清楚,AI 就最容易把这个能力真正调起来。diff --git a/unrealinsights/agent-harness/cli_anything/unrealinsights/README.md b/unrealinsights/agent-harness/cli_anything/unrealinsights/README.mdindex 96de51ab6..a81449bf1 100644--- a/unrealinsights/agent-harness/cli_anything/unrealinsights/README.md+++ b/unrealinsights/agent-harness/cli_anything/unrealinsights/README.md@@ -43,6 +43,21 @@ cli-anything-unrealinsights --json backend ensure-insights `# Bind a trace file for the current sessioncli-anything-unrealinsights trace set D:\captures\session.utrace+# Start a background capture session and keep it running+cli-anything-unrealinsights --json capture start `+ --project 'D:\Projects\MyGame\MyGame.uproject' `+ --engine-root 'D:\Program Files\Epic Games\UE_5.5' `+ --output-trace D:\captures\live_session.utrace++# Check current capture status+cli-anything-unrealinsights --json capture status++# Create a best-effort snapshot without ending the session+cli-anything-unrealinsights --json capture snapshot D:\captures\live_snapshot.utrace++# Stop the tracked capture session+cli-anything-unrealinsights --json capture stop+# Export threadscli-anything-unrealinsights --json -t D:\captures\session.utrace export threads D:\out\threads.csv@@ -76,6 +91,10 @@ cli-anything-unrealinsights- `info`- `capture`- `run`+ - `start`+ - `status`+ - `stop`+ - `snapshot`- `export`- `threads`- `timers`@@ -134,6 +153,24 @@ Notes:- If `target_exe` is omitted, `capture run` resolves `UnrealEditor.exe` from `--engine-root`.- The original explicit `target_exe` path remains supported.+## Continuous AI-Driven Capture++For longer-running sessions, prefer this loop:++```powershell+cli-anything-unrealinsights --json capture start --project ... --engine-root ...+cli-anything-unrealinsights --json capture status+cli-anything-unrealinsights --json capture snapshot+cli-anything-unrealinsights --json capture stop+```++Behavior:++- `capture start` launches the target in the background and persists the tracked PID/trace/session metadata+- `capture status` reads the persisted session state and reports whether the process is still running and how large the trace has grown+- `capture snapshot` creates a best-effort copy of the current `.utrace` without requiring you to end the session first+- `capture stop` performs a best-effort stop of the tracked process tree launched by the harness+## Export Filters`timing-events` and `timer-stats` support:diff --git a/unrealinsights/agent-harness/cli_anything/unrealinsights/core/capture.py b/unrealinsights/agent-harness/cli_anything/unrealinsights/core/capture.pyindex 89e4d3864..e873a1bf8 100644--- a/unrealinsights/agent-harness/cli_anything/unrealinsights/core/capture.py+++ b/unrealinsights/agent-harness/cli_anything/unrealinsights/core/capture.py@@ -5,6 +5,7 @@ Capture orchestration helpers.from __future__ import annotationsimport os+import shutilimport timefrom pathlib import Pathfrom typing import Sequence@@ -167,3 +168,60 @@ def run_capture(})return result+++def capture_status(session) -> dict[str, object]:+ """Return the current tracked capture status."""+ info = session.capture_info()+ pid = info.get("pid")+ info["running"] = backend.is_process_running(pid) if pid else False+ return info+++def stop_capture(session, force: bool = False, timeout: float | None = None) -> dict[str, object]:+ """Stop the currently tracked capture process."""+ info = capture_status(session)+ pid = info.get("pid")+ if not pid:+ raise RuntimeError("No active capture session is being tracked.")++ termination = backend.terminate_process(int(pid), force=force, timeout=timeout)+ status = capture_status(session)+ result = {+ "termination": termination,+ "capture": status,+ }+ if termination.get("stopped"):+ session.clear_capture()+ result["capture"] = session.capture_info()+ if info.get("trace_path"):+ session.set_trace(info["trace_path"])+ return result+++def snapshot_capture(session, output_trace: str | None = None) -> dict[str, object]:+ """Create a best-effort copy of the current trace file."""+ info = capture_status(session)+ source = info.get("trace_path")+ if not source:+ raise RuntimeError("No active capture trace is available to snapshot.")++ source_path = Path(source).expanduser().resolve()+ if not source_path.is_file():+ raise RuntimeError(f"Trace file not found: {source_path}")++ if output_trace:+ output_path = Path(output_trace).expanduser().resolve()+ else:+ timestamp = time.strftime("%Y%m%d-%H%M%S")+ output_path = source_path.with_name(f"{source_path.stem}-snapshot-{timestamp}{source_path.suffix}")++ output_path.parent.mkdir(parents=True, exist_ok=True)+ shutil.copy2(source_path, output_path)+ return {+ "source_trace": str(source_path),+ "snapshot_trace": str(output_path),+ "snapshot_exists": output_path.is_file(),+ "snapshot_size": output_path.stat().st_size if output_path.is_file() else None,+ "capture_running": info.get("running", False),+ }diff --git a/unrealinsights/agent-harness/cli_anything/unrealinsights/core/session.py b/unrealinsights/agent-harness/cli_anything/unrealinsights/core/session.pyindex e6de13ae9..cf18c2e90 100644--- a/unrealinsights/agent-harness/cli_anything/unrealinsights/core/session.py+++ b/unrealinsights/agent-harness/cli_anything/unrealinsights/core/session.py@@ -1,11 +1,30 @@"""-In-memory session state for Unreal Insights CLI workflows.+Persistent session state for Unreal Insights CLI workflows."""from __future__ import annotations-from dataclasses import dataclass+import json+import os+from dataclasses import asdict, dataclass, field+from datetime import datetime, timezonefrom pathlib import Path+from typing import Any+++def _normalize_path(path: str | None) -> str | None:+ return str(Path(path).expanduser().resolve()) if path else None+++def _state_dir() -> Path:+ override = os.environ.get("CLI_ANYTHING_UNREALINSIGHTS_STATE_DIR", "").strip()+ base = Path(override).expanduser() if override else Path.home() / ".cli-anything-unrealinsights"+ base.mkdir(parents=True, exist_ok=True)+ return base.resolve()+++def _state_file() -> Path:+ return _state_dir() / "session.json"@dataclass@@ -13,17 +32,93 @@ class UnrealInsightsSession:trace_path: str | None = Noneinsights_exe: str | None = Nonetrace_server_exe: str | None = None+ capture_pid: int | None = None+ capture_target_exe: str | None = None+ capture_target_args: list[str] = field(default_factory=list)+ capture_project_path: str | None = None+ capture_engine_root: str | None = None+ capture_trace_path: str | None = None+ capture_channels: str | None = None+ capture_started_at: str | None = None++ @classmethod+ def load(cls) -> "UnrealInsightsSession":+ path = _state_file()+ if not path.is_file():+ return cls()++ try:+ data = json.loads(path.read_text(encoding="utf-8"))+ except (OSError, json.JSONDecodeError):+ return cls()++ return cls(+ trace_path=data.get("trace_path"),+ insights_exe=data.get("insights_exe"),+ trace_server_exe=data.get("trace_server_exe"),+ capture_pid=data.get("capture_pid"),+ capture_target_exe=data.get("capture_target_exe"),+ capture_target_args=list(data.get("capture_target_args", [])),+ capture_project_path=data.get("capture_project_path"),+ capture_engine_root=data.get("capture_engine_root"),+ capture_trace_path=data.get("capture_trace_path"),+ capture_channels=data.get("capture_channels"),+ capture_started_at=data.get("capture_started_at"),+ )++ def save(self):+ path = _state_file()+ tmp = path.with_suffix(".tmp")+ tmp.write_text(json.dumps(asdict(self), indent=2), encoding="utf-8")+ os.replace(tmp, path)def set_trace(self, trace_path: str | None):- self.trace_path = str(Path(trace_path).expanduser().resolve()) if trace_path else None+ self.trace_path = _normalize_path(trace_path)+ self.save()def set_insights_exe(self, path: str | None):- self.insights_exe = str(Path(path).expanduser().resolve()) if path else None+ self.insights_exe = _normalize_path(path)+ self.save()def set_trace_server_exe(self, path: str | None):- self.trace_server_exe = str(Path(path).expanduser().resolve()) if path else None+ self.trace_server_exe = _normalize_path(path)+ self.save()++ def set_capture(+ self,+ *,+ pid: int | None,+ target_exe: str,+ target_args: list[str],+ trace_path: str,+ channels: str,+ project_path: str | None = None,+ engine_root: str | None = None,+ ):+ self.capture_pid = pid+ self.capture_target_exe = _normalize_path(target_exe)+ self.capture_target_args = list(target_args)+ self.capture_trace_path = _normalize_path(trace_path)+ self.capture_channels = channels+ self.capture_project_path = _normalize_path(project_path)+ self.capture_engine_root = _normalize_path(engine_root)+ self.capture_started_at = datetime.now(timezone.utc).isoformat()+ if self.capture_trace_path:+ self.trace_path = self.capture_trace_path+ self.save()++ def clear_capture(self):+ self.capture_pid = None+ self.capture_target_exe = None+ self.capture_target_args = []+ self.capture_project_path = None+ self.capture_engine_root = None+ self.capture_trace_path = None+ self.capture_channels = None+ self.capture_started_at = None+ self.save()- def trace_info(self) -> dict[str, object]:+ def trace_info(self) -> dict[str, Any]:if self.trace_path is None:return {"trace_path": None,@@ -36,3 +131,20 @@ class UnrealInsightsSession:"exists": path.is_file(),"file_size": path.stat().st_size if path.is_file() else None,}++ def capture_info(self) -> dict[str, Any]:+ trace_path = self.capture_trace_path or self.trace_path+ path = Path(trace_path) if trace_path else None+ return {+ "active": self.capture_pid is not None or self.capture_trace_path is not None,+ "pid": self.capture_pid,+ "target_exe": self.capture_target_exe,+ "target_args": list(self.capture_target_args),+ "project_path": self.capture_project_path,+ "engine_root": self.capture_engine_root,+ "trace_path": str(path) if path else None,+ "trace_exists": path.is_file() if path else False,+ "trace_size": path.stat().st_size if path and path.is_file() else None,+ "channels": self.capture_channels,+ "started_at": self.capture_started_at,+ }diff --git a/unrealinsights/agent-harness/cli_anything/unrealinsights/skills/SKILL.md b/unrealinsights/agent-harness/cli_anything/unrealinsights/skills/SKILL.mdindex 8943b48da..b865a28b8 100644--- a/unrealinsights/agent-harness/cli_anything/unrealinsights/skills/SKILL.md+++ b/unrealinsights/agent-harness/cli_anything/unrealinsights/skills/SKILL.md@@ -62,6 +62,22 @@ cli-anything-unrealinsights --json capture run `--target-arg 'D:\Projects\MyGame\MyGame.uproject'```+### Continuous capture session control++```powershell+cli-anything-unrealinsights --json capture start `+ --project 'D:\Projects\MyGame\MyGame.uproject' `+ --engine-root 'D:\Program Files\Epic Games\UE_5.5' `+ --output-trace D:\captures\live_session.utrace++cli-anything-unrealinsights --json capture status+cli-anything-unrealinsights --json capture snapshot D:\captures\live_snapshot.utrace+cli-anything-unrealinsights --json capture stop+```++This is the preferred flow when an agent needs to start profiling now and stop+or snapshot later in a follow-up turn.+### Offline exporters```powershell@@ -94,9 +110,19 @@ cli-anything-unrealinsights --json -t D:\captures\session.utrace batch run-rsp D- `trace_exists`- `trace_size`- `pid` or `exit_code`+- Continuous capture status returns:+ - `pid`+ - `running`+ - `target_exe`+ - `project_path`+ - `trace_path`+ - `trace_size`+ - `started_at`## Notes- v1 is Windows-first.- v1 supports file-mode capture orchestration only.- v1 does not control already-running UE instances or browse trace stores.+- `capture stop` is a best-effort stop of the harness-launched process tree.+- `capture snapshot` is a best-effort filesystem snapshot of the active trace.diff --git a/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/TEST.md b/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/TEST.mdindex f9492a3ee..5220c5b5e 100644--- a/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/TEST.md+++ b/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/TEST.md@@ -2,7 +2,7 @@## Test Inventory Plan-- `test_core.py`: 39 unit tests planned+- `test_core.py`: 46 unit tests planned- `test_full_e2e.py`: 10 E2E tests planned## Unit Test Plan@@ -19,7 +19,8 @@- Validate traced target command construction- Validate `-ExecCmds=` joining semantics- Validate `--project + --engine-root` convenience resolution-- Planned tests: 8+- Validate tracked capture status, snapshot, and stop flows+- Planned tests: 11### `core/export.py`- Validate exporter command strings for all supported exporters@@ -33,7 +34,8 @@- Validate JSON error payloads when trace/backend requirements are missing- Validate REPL session trace state- Validate capture convenience-layer argument handling-- Planned tests: 7+- Validate `capture status`, `capture stop`, and `capture snapshot` JSON flows+- Planned tests: 10## E2E Test Plan@@ -92,7 +94,7 @@ cli-anything-unrealinsights --json backend info### Result summary-- `test_core.py`: 39 passed+- `test_core.py`: 46 passed- `test_full_e2e.py`: 1 passed, 9 skipped- Manual smoke: installed entrypoint resolved local UE 5.5 binaries successfully@@ -111,7 +113,7 @@ cli-anything-unrealinsights --json backend infoplatform win32 -- Python 3.11.9, pytest-9.0.3, pluggy-1.6.0 -- C:\Users\aimidi\AppData\Local\Programs\Python\Python311\python.execachedir: .pytest_cacherootdir: D:\code\D5\CLI-Anything-unrealinsights\unrealinsights\agent-harness-collecting ... collected 39 items+collecting ... collected 46 itemscli_anything/unrealinsights/tests/test_core.py::TestOutputUtils::test_output_json PASSED [ 3%]cli_anything/unrealinsights/tests/test_core.py::TestOutputUtils::test_output_table_empty PASSED [ 7%]@@ -146,7 +148,7 @@ cli_anything/unrealinsights/tests/test_core.py::TestCLIJsonErrors::test_capture_cli_anything/unrealinsights/tests/test_core.py::TestREPLSessionState::test_trace_set_then_info_in_repl PASSED [ 99%]cli_anything/unrealinsights/tests/test_core.py::TestCaptureCLIConvenience::test_capture_run_with_project_and_engine_root PASSED [100%]-============================= 39 passed in 0.52s ==============================+============================= 46 passed in 0.28s =========================================================== test session starts =============================platform win32 -- Python 3.11.9, pytest-9.0.3, pluggy-1.6.0 -- C:\Users\aimidi\AppData\Local\Programs\Python\Python311\python.exediff --git a/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/test_core.py b/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/test_core.pyindex 061a13746..8e1e2683e 100644--- a/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/test_core.py+++ b/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/test_core.py@@ -12,6 +12,11 @@ import pytestfrom click.testing import CliRunner[email protected](autouse=True)+def _session_state_dir(tmp_path, monkeypatch):+ monkeypatch.setenv("CLI_ANYTHING_UNREALINSIGHTS_STATE_DIR", str(tmp_path / "state"))++class TestOutputUtils:def test_output_json(self):import io@@ -260,6 +265,58 @@ class TestCaptureCore:assert any(arg.startswith("-tracefile=") for arg in command)assert any(arg.startswith("-ExecCmds=") for arg in command)+ def test_capture_status(self):+ from cli_anything.unrealinsights.core.capture import capture_status+ from cli_anything.unrealinsights.core.session import UnrealInsightsSession++ session = UnrealInsightsSession()+ session.set_capture(+ pid=1234,+ target_exe="C:/UE/UnrealEditor.exe",+ target_args=["Project.uproject"],+ trace_path="C:/trace.utrace",+ channels="default",+ )+ with patch("cli_anything.unrealinsights.core.capture.backend.is_process_running", return_value=True):+ data = capture_status(session)+ assert data["active"] is True+ assert data["running"] is True++ def test_snapshot_capture(self, tmp_path):+ from cli_anything.unrealinsights.core.capture import snapshot_capture+ from cli_anything.unrealinsights.core.session import UnrealInsightsSession++ trace = tmp_path / "live.utrace"+ trace.write_text("trace-data", encoding="utf-8")+ session = UnrealInsightsSession()+ session.set_capture(+ pid=4321,+ target_exe="C:/UE/UnrealEditor.exe",+ target_args=[],+ trace_path=str(trace),+ channels="default",+ )+ with patch("cli_anything.unrealinsights.core.capture.backend.is_process_running", return_value=True):+ result = snapshot_capture(session)+ assert Path(result["snapshot_trace"]).is_file()++ def test_stop_capture(self):+ from cli_anything.unrealinsights.core.capture import stop_capture+ from cli_anything.unrealinsights.core.session import UnrealInsightsSession++ session = UnrealInsightsSession()+ session.set_capture(+ pid=9876,+ target_exe="C:/UE/UnrealEditor.exe",+ target_args=[],+ trace_path="C:/trace.utrace",+ channels="default",+ )+ with patch("cli_anything.unrealinsights.core.capture.backend.terminate_process", return_value={"requested_pid": 9876, "stopped": True, "exit_code": 0}), \+ patch("cli_anything.unrealinsights.core.capture.backend.is_process_running", return_value=False):+ result = stop_capture(session)+ assert result["termination"]["stopped"] is True+class TestExportCore:@pytest.mark.parametrize(@@ -429,6 +486,64 @@ class TestCLIJsonErrors:data = json.loads(result.output)assert data["insights"]["path"].endswith("UnrealInsights.exe")+ @patch("cli_anything.unrealinsights.unrealinsights_cli.capture_status")+ def test_capture_status_json(self, mock_capture_status):+ from cli_anything.unrealinsights.unrealinsights_cli import cli++ mock_capture_status.return_value = {+ "active": True,+ "pid": 1234,+ "running": True,+ "target_exe": "C:/UE/UnrealEditor.exe",+ "target_args": [],+ "project_path": "C:/Project.uproject",+ "engine_root": "C:/UE_5.3",+ "trace_path": "C:/trace.utrace",+ "trace_exists": True,+ "trace_size": 1024,+ "channels": "default",+ "started_at": "2026-04-16T00:00:00+00:00",+ }++ runner = CliRunner()+ result = runner.invoke(cli, ["--json", "capture", "status"])+ assert result.exit_code == 0+ data = json.loads(result.output)+ assert data["running"] is True++ @patch("cli_anything.unrealinsights.unrealinsights_cli.stop_capture")+ def test_capture_stop_json(self, mock_stop_capture):+ from cli_anything.unrealinsights.unrealinsights_cli import cli++ mock_stop_capture.return_value = {+ "termination": {"requested_pid": 1234, "stopped": True, "exit_code": 0},+ "capture": {"active": False},+ }++ runner = CliRunner()+ result = runner.invoke(cli, ["--json", "capture", "stop"])+ assert result.exit_code == 0+ data = json.loads(result.output)+ assert data["termination"]["stopped"] is True++ @patch("cli_anything.unrealinsights.unrealinsights_cli.snapshot_capture")+ def test_capture_snapshot_json(self, mock_snapshot_capture):+ from cli_anything.unrealinsights.unrealinsights_cli import cli++ mock_snapshot_capture.return_value = {+ "source_trace": "C:/trace.utrace",+ "snapshot_trace": "C:/trace-snapshot.utrace",+ "snapshot_exists": True,+ "snapshot_size": 2048,+ "capture_running": True,+ }++ runner = CliRunner()+ result = runner.invoke(cli, ["--json", "capture", "snapshot"])+ assert result.exit_code == 0+ data = json.loads(result.output)+ assert data["snapshot_exists"] is True+class TestREPLSessionState:def test_trace_set_then_info_in_repl(self):@@ -496,3 +611,51 @@ class TestCaptureCLIConvenience:mock_run_capture.assert_called_once()_, kwargs = mock_run_capture.call_argsassert kwargs["target_args"][0] == str(project.resolve())++ @patch("cli_anything.unrealinsights.unrealinsights_cli.run_capture")+ def test_capture_start_persists_background_session(self, mock_run_capture, tmp_path):+ from cli_anything.unrealinsights.unrealinsights_cli import cli+ from cli_anything.unrealinsights.core.session import UnrealInsightsSession++ editor = tmp_path / "UE_5.5" / "Engine" / "Binaries" / "Win64" / "UnrealEditor.exe"+ editor.parent.mkdir(parents=True)+ editor.write_text("x", encoding="utf-8")+ project = tmp_path / "Project" / "MyGame.uproject"+ project.parent.mkdir(parents=True)+ project.write_text("{}", encoding="utf-8")++ mock_run_capture.return_value = {+ "command": [str(editor.resolve()), str(project.resolve()), "-trace=default"],+ "waited": False,+ "timed_out": False,+ "exit_code": None,+ "stdout": None,+ "stderr": None,+ "pid": 2468,+ "target_exe": str(editor.resolve()),+ "target_args": [str(project.resolve())],+ "trace_path": str((tmp_path / "capture.utrace").resolve()),+ "channels": "default",+ "trace_exists": False,+ "trace_size": None,+ "succeeded": True,+ }++ runner = CliRunner()+ result = runner.invoke(+ cli,+ [+ "--json",+ "capture",+ "start",+ "--project",+ str(project),+ "--engine-root",+ str(tmp_path / "UE_5.5"),+ "--output-trace",+ str(tmp_path / "capture.utrace"),+ ],+ )+ assert result.exit_code == 0+ session = UnrealInsightsSession.load()+ assert session.capture_pid == 2468diff --git a/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/test_full_e2e.py b/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/test_full_e2e.pyindex de2cb5c9c..52b61e4e1 100644--- a/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/test_full_e2e.py+++ b/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/test_full_e2e.py@@ -47,6 +47,7 @@ def _cli_env():env = os.environ.copy()pythonpath = env.get("PYTHONPATH", "")env["PYTHONPATH"] = HARNESS_ROOT if not pythonpath else f"{HARNESS_ROOT}{os.pathsep}{pythonpath}"+ env["CLI_ANYTHING_UNREALINSIGHTS_STATE_DIR"] = os.path.join(HARNESS_ROOT, ".tmp_state")return envdiff --git a/unrealinsights/agent-harness/cli_anything/unrealinsights/unrealinsights_cli.py b/unrealinsights/agent-harness/cli_anything/unrealinsights/unrealinsights_cli.pyindex 38494e7de..c8b1a50a1 100644--- a/unrealinsights/agent-harness/cli_anything/unrealinsights/unrealinsights_cli.py+++ b/unrealinsights/agent-harness/cli_anything/unrealinsights/unrealinsights_cli.py@@ -14,9 +14,12 @@ import clickfrom cli_anything.unrealinsights import __version__from cli_anything.unrealinsights.core.capture import (DEFAULT_CHANNELS,+ capture_status,normalize_trace_output_path,resolve_capture_target,run_capture,+ snapshot_capture,+ stop_capture,)from cli_anything.unrealinsights.core.export import execute_export, execute_response_filefrom cli_anything.unrealinsights.core.session import UnrealInsightsSession@@ -35,7 +38,7 @@ def _get_session(ctx: click.Context) -> UnrealInsightsSession:ctx.ensure_object(dict)session = ctx.obj.get("session")if session is None:- session = UnrealInsightsSession()+ session = UnrealInsightsSession.load()ctx.obj["session"] = sessionreturn session@@ -154,6 +157,41 @@ def _human_capture_result(data: dict[str, object]):click.echo(f"PID: {data['pid']}")+def _human_capture_status(data: dict[str, object]):+ if not data.get("active"):+ click.echo("No tracked capture session.")+ return+ click.echo(f"PID: {data.get('pid')}")+ click.echo(f"Running: {'yes' if data.get('running') else 'no'}")+ click.echo(f"Target exe: {data.get('target_exe')}")+ if data.get("project_path"):+ click.echo(f"Project: {data['project_path']}")+ if data.get("engine_root"):+ click.echo(f"Engine root: {data['engine_root']}")+ click.echo(f"Trace: {data.get('trace_path')}")+ click.echo(f"Trace exists: {'yes' if data.get('trace_exists') else 'no'}")+ if data.get("trace_exists"):+ click.echo(f"Trace size: {format_size(data.get('trace_size'))}")+ if data.get("started_at"):+ click.echo(f"Started at: {data['started_at']}")+++def _human_snapshot_result(data: dict[str, object]):+ click.echo(f"Source trace: {data['source_trace']}")+ click.echo(f"Snapshot trace: {data['snapshot_trace']}")+ click.echo(f"Exists: {'yes' if data['snapshot_exists'] else 'no'}")+ if data.get("snapshot_exists"):+ click.echo(f"Size: {format_size(data.get('snapshot_size'))}")+ click.echo(f"Capture running:{' yes' if data.get('capture_running') else ' no'}")+++def _human_stop_result(data: dict[str, object]):+ termination = data["termination"]+ click.echo(f"Requested PID: {termination['requested_pid']}")+ click.echo(f"Stopped: {'yes' if termination['stopped'] else 'no'}")+ click.echo(f"Exit code: {termination.get('exit_code')}")++@click.group(invoke_without_command=True)@click.option("--json", "json_mode", is_flag=True, help="Output in JSON format.")@click.option("--debug", is_flag=True, help="Show debug tracebacks on errors.")@@ -315,11 +353,89 @@ def capture_run(ctx, target_exe, project, engine_root, target_args, output_trace)data.update(launch_info)session.set_trace(resolved_output)+ if wait:+ session.clear_capture()+ else:+ session.set_capture(+ pid=data.get("pid"),+ target_exe=resolved_target_exe,+ target_args=resolved_target_args,+ trace_path=resolved_output,+ channels=channels,+ project_path=launch_info.get("project_path"),+ engine_root=launch_info.get("engine_root"),+ )_output(ctx, data, _human_capture_result)except Exception as exc:_handle_exc(ctx, exc)+@capture_group.command("start")[email protected]("target_exe", required=False, type=click.Path(exists=False))[email protected]("--project", type=click.Path(exists=False), default=None, help="Path to a .uproject file.")+ "--engine-root",+ type=click.Path(exists=False),+ default=None,+ help="UE install root such as D:\\Program Files\\Epic Games\\UE_5.5 or its Engine subdir.",+)[email protected]("--target-arg", "target_args", multiple=True, help="Argument to pass to the target executable.")[email protected]("--output-trace", type=click.Path(exists=False), default=None, help="Output .utrace path.")[email protected]("--channels", default=DEFAULT_CHANNELS, show_default=True, help="Comma-separated UE trace channels.")[email protected]("--exec-cmd", "exec_cmds", multiple=True, help="Startup UE console command for -ExecCmds.")[email protected]_context+def capture_start(ctx, target_exe, project, engine_root, target_args, output_trace, channels, exec_cmds):+ """Launch a traced target in the background and track the session."""+ ctx.invoke(+ capture_run,+ target_exe=target_exe,+ project=project,+ engine_root=engine_root,+ target_args=target_args,+ output_trace=output_trace,+ channels=channels,+ exec_cmds=exec_cmds,+ wait=False,+ timeout=None,+ )+++@capture_group.command("status")[email protected]_context+def capture_status_cmd(ctx):+ """Show the tracked background capture status."""+ try:+ data = capture_status(_get_session(ctx))+ _output(ctx, data, _human_capture_status)+ except Exception as exc:+ _handle_exc(ctx, exc)+++@capture_group.command("stop")[email protected]("--force", is_flag=True, help="Force terminate the process tree.")[email protected]("--timeout", type=float, default=None, help="Optional stop timeout in seconds.")[email protected]_context+def capture_stop_cmd(ctx, force, timeout):+ """Stop the tracked capture process."""+ try:+ data = stop_capture(_get_session(ctx), force=force, timeout=timeout)+ _output(ctx, data, _human_stop_result)+ except Exception as exc:+ _handle_exc(ctx, exc)+++@capture_group.command("snapshot")[email protected]("output_trace", required=False, type=click.Path(exists=False))[email protected]_context+def capture_snapshot_cmd(ctx, output_trace):+ """Create a best-effort snapshot copy of the current trace."""+ try:+ data = snapshot_capture(_get_session(ctx), output_trace=output_trace)+ _output(ctx, data, _human_snapshot_result)+ except Exception as exc:+ _handle_exc(ctx, exc)++@cli.group("export")def export_group():"""Offline Unreal Insights exporters."""@@ -528,9 +644,9 @@ def repl(ctx):pt_session = skin.create_prompt_session()repl_commands = {- "backend": "info",+ "backend": "info|ensure-insights","trace": "set|info",- "capture": "run",+ "capture": "run|start|status|stop|snapshot","export": "threads|timers|timing-events|timer-stats|timer-callees|counters|counter-values","batch": "run-rsp","help": "Show this help",diff --git a/unrealinsights/agent-harness/cli_anything/unrealinsights/utils/unrealinsights_backend.py b/unrealinsights/agent-harness/cli_anything/unrealinsights/utils/unrealinsights_backend.pyindex 042f7b277..ede607e2b 100644--- a/unrealinsights/agent-harness/cli_anything/unrealinsights/utils/unrealinsights_backend.py+++ b/unrealinsights/agent-harness/cli_anything/unrealinsights/utils/unrealinsights_backend.py@@ -6,9 +6,11 @@ from __future__ import annotationsimport osimport re+import signalimport subprocess-from pathlib import Pathfrom datetime import datetime+from pathlib import Path+import timefrom typing import IterableINSIGHTS_BINARY_NAME = "UnrealInsights.exe"@@ -418,6 +420,73 @@ def run_process(command: list[str] | str, timeout: float | None = None, wait: bo}+def is_process_running(pid: int | None) -> bool:+ """Check whether a process is still running."""+ if not pid or pid <= 0:+ return False++ if os.name == "nt":+ result = subprocess.run(+ ["tasklist", "/FI", f"PID eq {pid}", "/FO", "CSV", "/NH"],+ capture_output=True,+ text=True,+ timeout=10,+ check=False,+ )+ stdout = result.stdout.strip()+ return bool(stdout) and "No tasks are running" not in stdout and "INFO:" not in stdout++ try:+ os.kill(pid, 0)+ return True+ except OSError:+ return False+++def terminate_process(pid: int, force: bool = False, timeout: float | None = None) -> dict[str, object]:+ """Terminate a process tree and report whether it stopped."""+ if pid <= 0:+ raise RuntimeError(f"Invalid PID: {pid}")++ if os.name == "nt":+ command = ["taskkill", "/PID", str(pid), "/T"]+ if force:+ command.append("/F")+ result = run_process(command, timeout=timeout, wait=True)+ else:+ sig = signal.SIGKILL if force else signal.SIGTERM+ try:+ os.kill(pid, sig)+ result = {+ "command": ["kill", str(sig), str(pid)],+ "waited": True,+ "timed_out": False,+ "exit_code": 0,+ "stdout": "",+ "stderr": "",+ "pid": None,+ }+ except OSError as exc:+ result = {+ "command": ["kill", str(sig), str(pid)],+ "waited": True,+ "timed_out": False,+ "exit_code": 1,+ "stdout": "",+ "stderr": str(exc),+ "pid": None,+ }++ deadline = time.time() + (timeout or 10)+ while time.time() < deadline and is_process_running(pid):+ time.sleep(0.25)++ result["stopped"] = not is_process_running(pid)+ result["requested_pid"] = pid+ result["force"] = force+ return result++def parse_unreal_log(log_path: str | Path) -> dict[str, object]:"""Extract warning and error lines from an Unreal log file."""path = Path(log_path).expanduser().resolve()