Skip to content

"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/.gitignore
index 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.md
index 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.&nbsp;&nbsp;[**中文文档**](README_CN.md) | [**日本語ドキュメント**](README_JA.md)
+**One Command Line**: Make any software agent-ready for Pi, OpenClaw, nanobot, Cursor, Claude Code, etc.&nbsp;&nbsp;[**中文文档**](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 APIs
2. 📐 **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 CL
Once 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` commands
3. 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.md
index 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.json
index 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.md
new file mode 100644
index 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.md
new file mode 100644
index 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.md
index 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 session
cli-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 threads
cli-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.py
index 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 annotations
import os
+import shutil
import time
from pathlib import Path
from 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.py
index 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, timezone
from 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 = None
insights_exe: str | None = None
trace_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.md
index 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.md
index 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 info
platform win32 -- Python 3.11.9, pytest-9.0.3, pluggy-1.6.0 -- C:\Users\aimidi\AppData\Local\Programs\Python\Python311\python.exe
cachedir: .pytest_cache
rootdir: D:\code\D5\CLI-Anything-unrealinsights\unrealinsights\agent-harness
-collecting ... collected 39 items
+collecting ... collected 46 items
cli_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.exe
diff --git a/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/test_core.py b/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/test_core.py
index 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 pytest
from 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_args
assert 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 == 2468
diff --git a/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/test_full_e2e.py b/unrealinsights/agent-harness/cli_anything/unrealinsights/tests/test_full_e2e.py
index 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 env
diff --git a/unrealinsights/agent-harness/cli_anything/unrealinsights/unrealinsights_cli.py b/unrealinsights/agent-harness/cli_anything/unrealinsights/unrealinsights_cli.py
index 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 click
from 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_file
from 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"] = session
return 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.")
+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")
+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.")
+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))
+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.py
index 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 annotations
import os
import re
+import signal
import subprocess
-from pathlib import Path
from datetime import datetime
+from pathlib import Path
+import time
from typing import Iterable
INSIGHTS_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()