From c30920207c2c55a662ba9b65c8075a3ea85ffe67 Mon Sep 17 00:00:00 2001 From: 27494539a-hub <27494539a@gmail.com> Date: Fri, 22 May 2026 21:37:58 +0800 Subject: [PATCH] fix(joplin):remove flag --- README.md | 742 +++++++-------- README_CN.md | 864 +++++++++--------- joplin/agent-harness/JOPLIN.md | 12 +- joplin/agent-harness/README.md | 4 +- .../cli_anything/joplin/README.md | 4 +- .../cli_anything/joplin/WORKFLOWS.md | 8 + .../cli_anything/joplin/core/notebooks.py | 19 +- .../cli_anything/joplin/core/notes.py | 45 +- .../cli_anything/joplin/skills/SKILL.md | 4 +- .../cli_anything/joplin/tests/TEST.md | 17 +- .../cli_anything/joplin/tests/test_core.py | 124 ++- skills/cli-anything-joplin/SKILL.md | 4 +- 12 files changed, 1023 insertions(+), 824 deletions(-) diff --git a/README.md b/README.md index 8db10534e..4db658724 100644 --- a/README.md +++ b/README.md @@ -5,15 +5,15 @@

- Today's Software Serves Humans👨‍💻. Tomorrow's Users will be Agents🤖.
+ Today's Software Serves Humans????. Tomorrow's Users will be Agents???.
CLI-Anything: Bridging the Gap Between AI Agents and the World's Software

-**🌐 [CLI-Hub](https://hkuds.github.io/CLI-Anything/)**: `pip install cli-anything-hub` then `cli-hub install ` — 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. +**? [CLI-Hub](https://hkuds.github.io/CLI-Anything/)**: `pip install cli-anything-hub` then `cli-hub install ` ?? 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 plus preview, live preview, and trajectory loops to produce real artifacts — CAD builds, 3D scenes, diagrams, gameplay, subtitles, and more. +**? [See Demos](#-real-world-demos)**: Watch AI agents use generated CLIs plus preview, live preview, and trajectory loops to produce real artifacts ?? CAD builds, 3D scenes, 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)! +**? [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)!

Quick Start @@ -24,8 +24,8 @@ CLI-Anything: Bridging the Gap Between AI Agents and the World's Software

- Python - Click + Python + Click Pytest Coverage Output @@ -33,7 +33,7 @@ CLI-Anything: Bridging the Gap Between AI Agents and the World's SoftwareWeChat

-**One Command Line**: Make any software agent-ready for Pi, OpenClaw, nanobot, Cursor, Claude Code, etc.  [**中文文档**](README_CN.md) | [**日本語ドキュメント**](README_JA.md) +**One Command Line**: Make any software agent-ready for Pi, OpenClaw, nanobot, Cursor, Claude Code, etc.  [**??ÎÄÎÄ??**](README_CN.md) | [**Èձ¾ÕZ¥É??¥å¥á¥ó¥È**](README_JA.md)

CLI-Anything typing demo @@ -45,129 +45,129 @@ CLI-Anything: Bridging the Gap Between AI Agents and the World's Software Thanks to all invaluable efforts from the community! More updates continuously on the way everyday.. -- **2026-05-20** 🎛️ **Rekordbox CLI** merged (#252) with guarded SQLCipher write paths, backup-required forced writes, smoke coverage, and root skill sync. 📚 **Calibre CLI** merged (#223) with library/search/metadata/conversion/export workflows, 41 unit tests, real-Calibre E2E evidence, and root skill validation. 🧊 **3MF CLI** merged (#209) with mesh inspection, hole resizing, repair, comparison, and preserved triangle attributes. 🎙️ **MiniMax CLI** merged (#189) with chat/TTS workflows, JSON-safe model/voice listing, REPL quote handling, and smoke/E2E coverage. 🎮 **UEAtelier** joined the registry (#297) as an Unreal Editor MCP self-extension workbench with a Python CLI proxy. +- **2026-05-20** ??? **Rekordbox CLI** merged (#252) with guarded SQLCipher write paths, backup-required forced writes, smoke coverage, and root skill sync. ? **Calibre CLI** merged (#223) with library/search/metadata/conversion/export workflows, 41 unit tests, real-Calibre E2E evidence, and root skill validation. ??? **3MF CLI** merged (#209) with mesh inspection, hole resizing, repair, comparison, and preserved triangle attributes. ??? **MiniMax CLI** merged (#189) with chat/TTS workflows, JSON-safe model/voice listing, REPL quote handling, and smoke/E2E coverage. ? **UEAtelier** joined the registry (#297) as an Unreal Editor MCP self-extension workbench with a Python CLI proxy. -- **2026-05-19** 🛠️ Existing harnesses got a quality/security pass — **Zoom** downloads recordings from direct URLs (#294), **Obsidian** search now uses the Local REST API vendor content types (#289), **LibreOffice** headless conversion is more robust on macOS (#290), and XML/SVG/ODF/MLT/MusicXML/CSL parsing now routes untrusted input through `defusedxml` (#296). +- **2026-05-19** ??? Existing harnesses got a quality/security pass ?? **Zoom** downloads recordings from direct URLs (#294), **Obsidian** search now uses the Local REST API vendor content types (#289), **LibreOffice** headless conversion is more robust on macOS (#290), and XML/SVG/ODF/MLT/MusicXML/CSL parsing now routes untrusted input through `defusedxml` (#296). -- **2026-05-18** 📈 README presentation refreshed with the Trendshift badge and centered project header polish (#285, #286), keeping the landing section focused on discovery and project momentum. +- **2026-05-18** ? README presentation refreshed with the Trendshift badge and centered project header polish (#285, #286), keeping the landing section focused on discovery and project momentum. -- **2026-05-17** 🌐 **CLI-Hub** registry handling was hardened (#281) — registry entries are now copied before `_source` tagging, preventing cached or mocked registry data from being mutated in place. +- **2026-05-17** ? **CLI-Hub** registry handling was hardened (#281) ?? registry entries are now copied before `_source` tagging, preventing cached or mocked registry data from being mutated in place. -- **2026-05-16** 🔧 **n8n** received the REPL banner crash fix that later merged into main (#280), restoring the no-subcommand interactive startup path with regression coverage. +- **2026-05-16** ? **n8n** received the REPL banner crash fix that later merged into main (#280), restoring the no-subcommand interactive startup path with regression coverage.

-Earlier news (Apr 10–18) +Earlier news (Apr 10??18) -- **2026-04-18** 🧩 **All SKILL.md files are now being unified under the top-level `skills/` directory** — every CLI skill can be installed from one canonical source with `npx skills add HKUDS/CLI-Anything --skill -g -y`. We also added root-skill validation CI, synced contribution / PR docs and REPL skill-path hints to the new layout, and refreshed the **CLI-Hub** install-first frontend around the new `npx skills` flow. +- **2026-04-18** ? **All SKILL.md files are now being unified under the top-level `skills/` directory** ?? every CLI skill can be installed from one canonical source with `npx skills add HKUDS/CLI-Anything --skill -g -y`. We also added root-skill validation CI, synced contribution / PR docs and REPL skill-path hints to the new layout, and refreshed the **CLI-Hub** install-first frontend around the new `npx skills` flow. -- **2026-04-17** 🌐 **CLI-Hub** received another install UX pass — public registry metadata and skill coverage were tightened, visit counting was corrected, and the web hub was further refined. 🧪 **Shotcut** render output duration was fixed (#92). 📝 **SKILL** contribution paths were corrected for the new docs flow (#224), and the skill generator now safely handles empty intros (#203). +- **2026-04-17** ? **CLI-Hub** received another install UX pass ?? public registry metadata and skill coverage were tightened, visit counting was corrected, and the web hub was further refined. ? **Shotcut** render output duration was fixed (#92). ? **SKILL** contribution paths were corrected for the new docs flow (#224), and the skill generator now safely handles empty intros (#203). -- **2026-04-16** 🗺️ **QGIS CLI** merged (#207) — a full GIS / map authoring harness landed. 🧬 **UniMol Tools CLI** merged (#219) for molecular modeling workflows. 🌐 **CLI-Hub** also added more public CLIs, including **py4csr**, refreshed its generated meta-skill, corrected SKILL contribution docs, and fixed `apt-get` package extraction in skill generation (#204). +- **2026-04-16** ??? **QGIS CLI** merged (#207) ?? a full GIS / map authoring harness landed. ? **UniMol Tools CLI** merged (#219) for molecular modeling workflows. ? **CLI-Hub** also added more public CLIs, including **py4csr**, refreshed its generated meta-skill, corrected SKILL contribution docs, and fixed `apt-get` package extraction in skill generation (#204). -- **2026-04-16** 📈 **Unreal Insights CLI** expanded — added background capture session control (`capture start/status/snapshot/stop`), engine-root-matched `UnrealInsights.exe` resolution/build flows, and refreshed docs/tests for the new orchestration workflow. +- **2026-04-16** ? **Unreal Insights CLI** expanded ?? added background capture session control (`capture start/status/snapshot/stop`), engine-root-matched `UnrealInsights.exe` resolution/build flows, and refreshed docs/tests for the new orchestration workflow. -- **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-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-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-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-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. +- **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.
-Earlier news (Apr 1–9) +Earlier news (Apr 1??9) -- **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-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-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-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-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-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. +- **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.
-Earlier news (Mar 23–30) +Earlier news (Mar 23??30) -- **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-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. +- **2026-03-29** ? Blender skill docs updated ?? enforce absolute render paths and correct prerequisites. -- **2026-03-28** 🌐 **CLIBrowser** added to CLI-Hub registry for agent-accessible browser automation. +- **2026-03-28** ? **CLIBrowser** added to CLI-Hub registry for agent-accessible browser automation. -- **2026-03-27** 📚 Zotero SKILL.md enhanced with agent-facing constraints; REPL config and executable resolution fixes. +- **2026-03-27** ? Zotero SKILL.md enhanced with agent-facing constraints; REPL config and executable resolution fixes. -- **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-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. FreeCAD updated for v1.1. 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. +- **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. **Krita CLI** harness merged for digital painting. +- **2026-03-23** ??? Launched **CLI-Hub meta-skill** ?? agents can now discover and install CLIs autonomously. **Krita CLI** harness merged for digital painting.
-Earlier news (Mar 11–22) +Earlier news (Mar 11??22) -- **2026-03-22** 🎵 **MuseScore CLI** merged with transpose, export, and instrument management. +- **2026-03-22** ? **MuseScore CLI** merged with transpose, export, and instrument management. -- **2026-03-21** 🔧 Infrastructure improvements — refined test harnesses and documentation across multiple CLIs. Enhanced Windows compatibility for several backends. +- **2026-03-21** ? Infrastructure improvements ?? refined test harnesses and documentation across multiple CLIs. Enhanced Windows compatibility for several backends. -- **2026-03-20** 🌐 **Novita AI** CLI added for OpenAI-compatible API access. Registry metadata improvements for better hub discovery. +- **2026-03-20** ? **Novita AI** CLI added for OpenAI-compatible API access. Registry metadata improvements for better hub discovery. -- **2026-03-19** 📦 Package structure refinements across harnesses. Improved SKILL.md generation with better command documentation. +- **2026-03-19** ? Package structure refinements across harnesses. Improved SKILL.md generation with better command documentation. -- **2026-03-18** 🧪 Test coverage expansion — additional E2E scenarios and edge case validation across multiple CLIs. +- **2026-03-18** ? Test coverage expansion ?? additional E2E scenarios and edge case validation across multiple CLIs. -- **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. +- **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. -- **2026-03-16** 🤖 Added **SKILL.md generation** (Phase 6.5) — every generated CLI now ships with an AI-discoverable skill definition. +- **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. +- **2026-03-15** ? Support for **OpenClaw** from the community! Merged Windows `cygpath` guard for cross-platform support. -- **2026-03-14** 🔒 Fixed a GIMP Script-Fu path injection vulnerability and added **Japanese README** translation. +- **2026-03-14** ? Fixed a GIMP Script-Fu path injection vulnerability and added **Japanese README** translation. -- **2026-03-13** 🔌 **Qodercli** plugin officially merged as a community contribution with dedicated setup scripts. +- **2026-03-13** ? **Qodercli** plugin officially merged as a community contribution with dedicated setup scripts. -- **2026-03-12** 📦 **Codex skill** integration landed, bringing CLI-Anything to yet another AI coding platform. +- **2026-03-12** ? **Codex skill** integration landed, bringing CLI-Anything to yet another AI coding platform. -- **2026-03-11** 📞 **Zoom** video conferencing harness added as the 11th supported application. +- **2026-03-11** ? **Zoom** video conferencing harness added as the 11th supported application.
--- -## 🤔 Why CLI? +## ??? Why CLI? CLI is the universal interface for both humans and AI agents: -• **Structured & Composable** - Text commands match LLM format and chain for complex workflows +?? **Structured & Composable** - Text commands match LLM format and chain for complex workflows -• **Lightweight & Universal** - Minimal overhead, works across all systems without dependencies +?? **Lightweight & Universal** - Minimal overhead, works across all systems without dependencies -• **Self-Describing** - --help flags provide automatic documentation agents can discover +?? **Self-Describing** - --help flags provide automatic documentation agents can discover -• **Proven Success** - Claude Code runs thousands of real workflows through CLI daily +?? **Proven Success** - Claude Code runs thousands of real workflows through CLI daily -• **Agent-First Design** - Structured JSON output eliminates parsing complexity +?? **Agent-First Design** - Structured JSON output eliminates parsing complexity -• **Deterministic & Reliable** - Consistent results enable predictable agent behavior +?? **Deterministic & Reliable** - Consistent results enable predictable agent behavior -## 🚀 Quick Start +## ? Quick Start ### Prerequisites @@ -178,7 +178,7 @@ CLI is the universal interface for both humans and AI agents: ### Pick Your Platform
-

⚡ Claude Code

+

?? Claude Code

**Step 1: Add the Marketplace** @@ -225,27 +225,27 @@ If you see `Unknown skill: cli-anything`, focus on plugin install/load first (bo - Older builds only: `/cli-anything:cli-anything ./gimp` This runs the full pipeline: -1. 🔍 **Analyze** — Scans source code, maps GUI actions to APIs -2. 📐 **Design** — Architects command groups, state model, output formats -3. 🔨 **Implement** — Builds Click CLI with REPL, JSON output, undo/redo -4. 📋 **Plan Tests** — Creates TEST.md with unit + E2E test plans -5. 🧪 **Write Tests** — Implements comprehensive test suite -6. 📝 **Document** — Updates TEST.md with results -7. 📦 **Publish** — Creates `setup.py`, installs to PATH +1. ? **Analyze** ?? Scans source code, maps GUI actions to APIs +2. ? **Design** ?? Architects command groups, state model, output formats +3. ? **Implement** ?? Builds Click CLI with REPL, JSON output, undo/redo +4. ? **Plan Tests** ?? Creates TEST.md with unit + E2E test plans +5. ? **Write Tests** ?? Implements comprehensive test suite +6. ? **Document** ?? Updates TEST.md with results +7. ? **Publish** ?? Creates `setup.py`, installs to PATH **Step 4 (Optional): Refine and Improve the CLI** After the initial build, you can iteratively refine the CLI to expand coverage and add missing capabilities: ```bash -# Broad refinement — agent analyzes gaps across all capabilities +# Broad refinement ?? agent analyzes gaps across all capabilities /cli-anything:refine ./gimp -# Focused refinement — target a specific functionality area +# Focused refinement ?? target a specific functionality area /cli-anything:refine ./gimp "I want more CLIs on image batch processing and filters" ``` -The refine command performs gap analysis between the software's full capabilities and current CLI coverage, then implements new commands, tests, and documentation for the identified gaps. You can run it multiple times to steadily expand coverage — each run is incremental and non-destructive. +The refine command performs gap analysis between the software's full capabilities and current CLI coverage, then implements new commands, tests, and documentation for the identified gaps. You can run it multiple times to steadily expand coverage ?? each run is incremental and non-destructive.
Alternative: Manual Installation @@ -268,7 +268,7 @@ cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything
-

⚡ Pi Coding Agent

+

?? Pi Coding Agent

**Step 1: Install the Extension** @@ -306,10 +306,10 @@ Once the extension is loaded, the following commands are available: **Step 3 (Optional): Refine and Improve the CLI** ```bash -# Broad refinement — agent analyzes gaps across all capabilities +# Broad refinement ?? agent analyzes gaps across all capabilities /cli-anything:refine ./gimp -# Focused refinement — target a specific functionality area +# Focused refinement ?? target a specific functionality area /cli-anything:refine ./gimp "batch processing and filters" ``` @@ -326,7 +326,7 @@ Once the extension is loaded, the following commands are available:
-

⚡ OpenCode (Experimental)

+

?? OpenCode (Experimental)

**Step 1: Install the Commands** @@ -368,17 +368,17 @@ The command runs as a subtask and follows the same 7-phase methodology as Claude **Step 3 (Optional): Refine and Improve the CLI** ```bash -# Broad refinement — agent analyzes gaps across all capabilities +# Broad refinement ?? agent analyzes gaps across all capabilities /cli-anything-refine ./gimp -# Focused refinement — target a specific functionality area +# Focused refinement ?? target a specific functionality area /cli-anything-refine ./gimp "batch processing and filters" ```
-

⚡ Goose (Desktop / CLI) Experimental Community

+

?? Goose (Desktop / CLI) Experimental Community

**Step 1: Install Goose** @@ -402,7 +402,7 @@ Once Goose is configured, start a session and use the same CLI-Anything commands
-

⚡ Qodercli Community

+

?? Qodercli Community

**Step 1: Register the Plugin** @@ -424,7 +424,7 @@ This registers the cli-anything plugin in `~/.qoder.json`. Start a new Qodercli
-

⚡ OpenClaw Community

+

?? OpenClaw Community

**Step 1: Install the Skill** @@ -451,7 +451,7 @@ The skill follows the same 7-phase methodology as Claude Code and OpenCode.
-

⚡ Codex Experimental Community

+

?? Codex Experimental Community

**Step 1: Install the Skill** @@ -491,7 +491,7 @@ OpenCode commands, while keeping the generated Python harness format unchanged.
-

⚡ GitHub Copilot CLI Community

+

?? GitHub Copilot CLI Community

**Step 1: Install the Plugin** @@ -514,14 +514,14 @@ This installs the CLI-Anything plugin to GitHub Copilot CLI. The plugin should n
-

🔮 More Platforms (Coming Soon)

+

? More Platforms (Coming Soon)

CLI-Anything is designed to be platform-agnostic. Support for more AI coding agents is planned: -- **Codex** — available via the bundled skill in `codex-skill/` -- **Cursor** — coming soon -- **Windsurf** — coming soon -- **Your favorite tool** — contributions welcome! See the `opencode-commands/` directory for a reference implementation. +- **Codex** ?? available via the bundled skill in `codex-skill/` +- **Cursor** ?? coming soon +- **Windsurf** ?? coming soon +- **Your favorite tool** ?? contributions welcome! See the `opencode-commands/` directory for a reference implementation.
@@ -546,9 +546,9 @@ Each in-repo harness now has a canonical [`SKILL.md`](#-skillmd-generation) at ` --- -## 🤖 Empower Your Agents with CLI-Hub +## ??? Empower Your Agents with CLI-Hub -CLI-Hub lets agents autonomously discover and install the CLIs they need — zero human intervention required. +CLI-Hub lets agents autonomously discover and install the CLIs they need ?? zero human intervention required. We published a **meta-skill** that lets any AI agent freely explore the full catalog of community CLIs and pick the right one for the task. @@ -568,7 +568,7 @@ nanobot skills install cli-anything-hub Find appropriate CLI software in CLI-Hub and complete the task: ``` -The agent will browse the catalog, install whichever CLI fits the task, and use it — all autonomously. +The agent will browse the catalog, install whichever CLI fits the task, and use it ?? all autonomously. **How it works under the hood:** @@ -576,42 +576,42 @@ The agent will browse the catalog, install whichever CLI fits the task, and use 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 -The catalog auto-updates whenever `registry.json` changes — new community CLIs show up automatically. +The catalog auto-updates whenever `registry.json` changes ?? new community CLIs show up automatically. > **For Claude Code users:** Copy [`skills/cli-hub-meta-skill/SKILL.md`](skills/cli-hub-meta-skill/SKILL.md) into your project or skills directory for the same automatic CLI discovery. --- -## 💡 CLI-Anything's Vision: Building Agent-Native Software +## ? CLI-Anything's Vision: Building Agent-Native Software -• 🌐 **Universal Access** - Every software becomes instantly agent-controllable through structured CLI. +?? ? **Universal Access** - Every software becomes instantly agent-controllable through structured CLI. -• 🔗 **Seamless Integration** - Agents control any application without APIs, GUI, rebuilding or complex wrappers. +?? ? **Seamless Integration** - Agents control any application without APIs, GUI, rebuilding or complex wrappers. -• 🚀 **Future-Ready Ecosystem** - Transform human-designed software into agent-native tools with one command. +?? ? **Future-Ready Ecosystem** - Transform human-designed software into agent-native tools with one command. --- -## 🔧 When to Use CLI-Anything +## ? When to Use CLI-Anything | Category | How to be Agent-native | Notable Examples | |----------|----------------------|----------| -| **📂 GitHub Repositories** | Transform any open-source project into agent-controllable tools through automatic CLI generation | VSCodium, WordPress, Calibre, Zotero, Joplin, Logseq, Penpot, Super Productivity | -| **🤖 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 | -| **🎮 Game Development** | Manage game projects, scenes, exports, and scripting through headless engine interfaces | **[Godot Engine](https://godotengine.org)**, **[s&box](https://sbox.game)** | -| **🔬 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 | +| **? GitHub Repositories** | Transform any open-source project into agent-controllable tools through automatic CLI generation | VSCodium, WordPress, Calibre, Zotero, Joplin, Logseq, Penpot, Super Productivity | +| **??? 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 | +| **? Game Development** | Manage game projects, scenes, exports, and scripting through headless engine interfaces | **[Godot Engine](https://godotengine.org)**, **[s&box](https://sbox.game)** | +| **? 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 | --- @@ -624,37 +624,37 @@ AI agents are great at reasoning but terrible at using real professional softwar | **Current Pain Point** | **CLI-Anything's Fix** | |----------|----------------------| -| 🤖 "AI can't use real tools" | Direct integration with actual software backends (Blender, LibreOffice, FFmpeg) — full professional capabilities, zero compromises | -| 💸 "UI automation breaks constantly" | No screenshots, no clicking, no RPA fragility. Pure command-line reliability with structured interfaces | -| 📊 "Agents need structured data" | Built-in JSON output for seamless agent consumption + human-readable formats for debugging | -| 🔧 "Custom integrations are expensive" | One Claude plugin auto-generates CLIs for ANY codebase through proven 7-phase pipeline | -| ⚡ "Prototype vs Production gap" | 2,280+ tests with real software validation. Battle-tested across 18 major applications | +| ??? "AI can't use real tools" | Direct integration with actual software backends (Blender, LibreOffice, FFmpeg) ?? full professional capabilities, zero compromises | +| ? "UI automation breaks constantly" | No screenshots, no clicking, no RPA fragility. Pure command-line reliability with structured interfaces | +| ? "Agents need structured data" | Built-in JSON output for seamless agent consumption + human-readable formats for debugging | +| ? "Custom integrations are expensive" | One Claude plugin auto-generates CLIs for ANY codebase through proven 7-phase pipeline | +| ?? "Prototype vs Production gap" | 2,280+ tests with real software validation. Battle-tested across 18 major applications | --- -## 🎯 What Can You Do with CLI-Anything? +## ? What Can You Do with CLI-Anything? @@ -662,19 +662,19 @@ CLI-Anything can flat-out **replace GUI-based agent approaches** — no more scr --- -## ✨ ⚙️ How CLI-Anything Works +## ?? ?? How CLI-Anything Works
-### 🛠️ Let Agents Take Your Workflows +### ??? Let Agents Take Your Workflows -Professional or everyday — just throw the codebase at `/cli-anything`. GIMP, Blender, Shotcut for creative work. LibreOffice, OBS Studio for daily tasks. Don't have the source? Find an open-source alternative and throw *that* in. You'll instantly get a full CLI your agents can use. +Professional or everyday ?? just throw the codebase at `/cli-anything`. GIMP, Blender, Shotcut for creative work. LibreOffice, OBS Studio for daily tasks. Don't have the source? Find an open-source alternative and throw *that* in. You'll instantly get a full CLI your agents can use. -### 🔗 Unify Scattered APIs into One CLI +### ? Unify Scattered APIs into One CLI -Tired of juggling fragmented web service APIs? Feed the docs or SDK manuscripts to `/cli-anything` and your agents get a **powerful, stateful CLI** that wraps those individual endpoints into coherent command groups. One tool instead of dozens of raw API calls — stronger capabilities while saving tokens. +Tired of juggling fragmented web service APIs? Feed the docs or SDK manuscripts to `/cli-anything` and your agents get a **powerful, stateful CLI** that wraps those individual endpoints into coherent command groups. One tool instead of dozens of raw API calls ?? stronger capabilities while saving tokens. -### 🚀 Replace or Supercharge GUI Agents +### ? Replace or Supercharge GUI Agents -CLI-Anything can flat-out **replace GUI-based agent approaches** — no more screenshots, no brittle pixel-clicking. But here's the fun part: once you `/cli-anything` a GUI software, you can **synthesize agent tasks, evaluators, and benchmarks** entirely via code and terminal — fully automated, iteratively refinable, massively more efficient. +CLI-Anything can flat-out **replace GUI-based agent approaches** ?? no more screenshots, no brittle pixel-clicking. But here's the fun part: once you `/cli-anything` a GUI software, you can **synthesize agent tasks, evaluators, and benchmarks** entirely via code and terminal ?? fully automated, iteratively refinable, massively more efficient.
@@ -682,13 +682,13 @@ Direct calls to real applications for actual rendering. LibreOffice generates PD @@ -696,20 +696,20 @@ Simple pip install -e . puts cli-anything- directly on PATH. Agents di
-### 🏗️ Fully Automated 7-Phase Pipeline -From codebase analysis to PyPI publishing — the plugin handles architecture design, implementation, test planning, test writing, and documentation completely automatically. +### ??? Fully Automated 7-Phase Pipeline +From codebase analysis to PyPI publishing ?? the plugin handles architecture design, implementation, test planning, test writing, and documentation completely automatically. -### 🎯 Authentic Software Integration +### ? Authentic Software Integration Direct calls to real applications for actual rendering. LibreOffice generates PDFs, Blender renders 3D scenes, Audacity processes audio via sox. **Zero compromises**, **Zero toy implementations**.
-### 🔁 Smart Session Management +### ? Smart Session Management Persistent project state with undo/redo capabilities, plus unified REPL interface (ReplSkin) that delivers consistent interactive experience across all CLIs. -### 📦 Zero-Config Installation +### ? Zero-Config Installation Simple pip install -e . puts cli-anything- directly on PATH. Agents discover tools via standard which commands. No setup, no wrappers.
-### 🧪 Production-Grade Testing +### ? Production-Grade Testing Multi-layered validation: unit tests with synthetic data, end-to-end tests with real files and software, plus CLI subprocess verification of installed commands. -### 🐍 Clean Package Architecture -All CLIs organized under cli_anything.* namespace — conflict-free, pip-installable, with consistent naming: cli-anything-gimp, cli-anything-blender, etc. +### ? Clean Package Architecture +All CLIs organized under cli_anything.* namespace ?? conflict-free, pip-installable, with consistent naming: cli-anything-gimp, cli-anything-blender, etc.
-### 🤖 SKILL.md Generation +### ??? SKILL.md Generation Each generated CLI now has a canonical `SKILL.md` at `skills/cli-anything-/SKILL.md`. This makes the current monorepo directly consumable by `npx skills`, while a packaged compatibility copy at `cli_anything//skills/SKILL.md` preserves installed-harness behavior. @@ -723,9 +723,9 @@ SKILL.md files are auto-generated during Phase 6.5 of the pipeline using `skill_ --- -## 🎬 Real-World Demos +## ? Real-World Demos -AI agents using generated CLIs to produce complete, useful artifacts — no GUI needed. +AI agents using generated CLIs to produce complete, useful artifacts ?? no GUI needed. ### FreeCAD — Curiosity Rover via Preview, Live Preview, and Trajectory @@ -759,7 +759,7 @@ An agent uses the Blender harness to grow a hard-surface orbital relay drone und > **Harness:** `cli-anything-drawio` | **Time:** ~4 min | **Artifact:** `.drawio` + `.png` -An agent creates a full HTTPS connection lifecycle diagram from scratch — TCP three-way handshake, TLS negotiation, encrypted data exchange, and TCP four-way termination — entirely through CLI commands. +An agent creates a full HTTPS connection lifecycle diagram from scratch ?? TCP three-way handshake, TLS negotiation, encrypted data exchange, and TCP four-way termination ?? entirely through CLI commands.

Draw.io CLI demo: building an HTTPS handshake diagram @@ -778,7 +778,7 @@ An agent creates a full HTTPS connection lifecycle diagram from scratch — TCP > **Harness:** `cli-anything-slay-the-spire-ii` | **Artifact:** Automated gameplay session -An agent plays through a Slay the Spire II run using the CLI harness — reading game state, selecting cards, choosing paths, and making strategic decisions in real-time. +An agent plays through a Slay the Spire II run using the CLI harness ?? reading game state, selecting cards, choosing paths, and making strategic decisions in real-time.

Slay the Spire II CLI gameplay demo @@ -809,19 +809,19 @@ An agent uses the VideoCaptioner CLI to automatically generate and overlay style --- -## 🎬 Demonstrations +## ? Demonstrations -### 🎯 General-Purpose -CLI-Anything works on any software with a codebase — no domain restrictions or architectural limitations. +### ? General-Purpose +CLI-Anything works on any software with a codebase ?? no domain restrictions or architectural limitations. -### 🏭 Professional-Grade Testing +### ? Professional-Grade Testing Tested across 18 diverse, complex applications spanning creative, productivity, communication, diagramming, AI image generation, AI content generation, network ad blocking, local LLM inference, native debugging, and graphics profiling domains previously inaccessible to AI agents. -### 🎨 Diverse Domain Coverage +### ? Diverse Domain Coverage From creative workflows (image editing, 3D modeling, vector graphics) to production tools (audio, office, live streaming, video editing). -### ✅ Full CLI Generation -Each application received complete, production-ready CLI interfaces — not demos, but comprehensive tool access preserving full capabilities. +### ?? Full CLI Generation +Each application received complete, production-ready CLI interfaces ?? not demos, but comprehensive tool access preserving full capabilities. @@ -832,438 +832,438 @@ Each application received complete, production-ready CLI interfaces — not demo - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - +
Tests
🎨 GIMP? GIMP Image Editing cli-anything-gimp Pillow + GEGL/Script-Fu✅ 107?? 107
🧊 Blender??? Blender 3D Modeling & Rendering cli-anything-blender bpy (Python scripting)✅ 208?? 208
✏️ Inkscape?? Inkscape Vector Graphics cli-anything-inkscape Direct SVG/XML manipulation✅ 202?? 202
🎵 Audacity? Audacity Audio Production cli-anything-audacity Python wave + sox✅ 161?? 161
🌐 Browser? Browser Browser Automation cli-anything-browser DOMShell MCP + Accessibility Tree✅ New?? New
📄 LibreOffice? LibreOffice Office Suite (Writer, Calc, Impress) cli-anything-libreoffice ODF generation + headless LO✅ 158?? 158
⚡ n8n?? n8n Workflow Automation cli-anything-n8n n8n REST API v1.1.1✅ 55+ cmds?? 55+ cmds
📧 Mailchimp? Mailchimp Email Marketing & Automation cli-anything-mailchimp Mailchimp Marketing API v3.0✅ 303 cmds?? 303 cmds
📚 Zotero? Zotero Reference Management cli-anything-zotero Local SQLite + connector + Local API✅ New?? New
📖 Calibre? Calibre E-book Library Management cli-anything-calibre calibredb + ebook-convert + ebook-meta✅ 58?? 58
📓 Joplin? Joplin Note-taking & To-dos cli-anything-joplin Joplin terminal CLI subprocess✅ 118?? 118
📝 Mubu? Mubu Knowledge Management & Outlining cli-anything-mubu Local Mubu data + sync logs✅ 96?? 96
📹 OBS Studio? OBS Studio Live Streaming & Recording cli-anything-obs-studio JSON scene + obs-websocket✅ 153?? 153
📱 NSLogger? NSLogger iOS/macOS Log Capture cli-anything-nslogger NSLogger wire protocol + native macOS Bonjour✅ 139?? 139
🎞️ Kdenlive??? Kdenlive Video Editing cli-anything-kdenlive MLT XML + melt renderer✅ 155?? 155
🎬 Shotcut? Shotcut Video Editing cli-anything-shotcut Direct MLT XML + melt✅ 154?? 154
🎬 Openscreen? Openscreen Screen Recording Editor cli-anything-openscreen ffmpeg backend✅ 101?? 101
📞 Zoom? Zoom Video Conferencing cli-anything-zoom Zoom REST API (OAuth2)✅ 22?? 22
🎵 MuseScore? MuseScore Music Notation cli-anything-musescore mscore CLI (MSCX/MusicXML)✅ 56?? 56
📐 Draw.io? Draw.io Diagramming cli-anything-drawio mxGraph XML + draw.io CLI✅ 138?? 138
⛓️ ETH2 QuickStart?? ETH2 QuickStart DevOps / Ethereum cli-anything-eth2-quickstart eth2-quickstart shell automation + JSON health checks✅ 18?? 18
🧜 Mermaid Live Editor??? Mermaid Live Editor Diagramming cli-anything-mermaid Mermaid state + mermaid.ink renderer✅ 10?? 10
✨ AnyGen?? AnyGen AI Content Generation cli-anything-anygen AnyGen REST API (anygen.io)✅ 50?? 50
🧠 NotebookLM??? NotebookLM AI Research Assistant cli-anything-notebooklm NotebookLM CLI wrapper (experimental)✅ 21?? 21
🧩 Dify Workflow? Dify Workflow Dify DSL Editing cli-anything-dify-workflow Wrapper around the open-source dify-workflow CLI✅ 11?? 11
🖼️ ComfyUI??? ComfyUI AI Image Generation cli-anything-comfyui ComfyUI REST API✅ 70?? 70
🛡️ AdGuard Home??? AdGuard Home Network-wide Ad Blocking cli-anything-adguardhome AdGuard Home REST API✅ 36?? 36
🦙 Ollama??? Ollama Local LLM Inference cli-anything-ollama Ollama REST API✅ 98?? 98
🧬 Uni-Mol Tools? Uni-Mol Tools Molecular Property Prediction (AI4S) cli-anything-unimol-tools Uni-Mol molecular ML backend✅ 67?? 67
🎬 VideoCaptioner? VideoCaptioner AI Video Captioning cli-anything-videocaptioner videocaptioner CLI (PyPI)✅ 26?? 26
🎨 Sketch? Sketch UI Design sketch-cli sketch-constructor (Node.js)✅ 19?? 19
🎮 Godot Engine? Godot Engine Game Development cli-anything-godot Godot 4.x headless subprocess✅ 24?? 24
📦 s&box? s&box Game Development cli-anything-sbox Source 2 game engine - direct file I/O on .scene/.prefab/.vmat/.vsnd JSON✅ 244?? 244
🐞 LLDB? LLDB Native Debugging cli-anything-lldb LLDB Python API✅ 27?? 27
🟩 Nsight Graphics CLI? Nsight Graphics CLI GPU Debugging & Profiling cli-anything-nsight-graphics Official ngfx / ngfx-capture orchestration + GPU Trace summary + replay analysis✅ 51?? 51
🔍 Exa? Exa AI-Native Web Search cli-anything-exa exa-py SDK✅ 40?? 40
📈 Unreal Insights? Unreal Insights Performance Profiling cli-anything-unrealinsights Background trace sessions + engine-matched UnrealInsights build + headless export✅ 50?? 50
☁️ CloudAnalyzer?? CloudAnalyzer Point cloud / trajectory QA cli-anything-cloudanalyzer CloudAnalyzer (Python API)✅ 14?? 14
🗺️ QGIS??? QGIS Geospatial Analysis & Mapping cli-anything-qgis PyQGIS + qgis_process✅ 22?? 22
🔩 3MF? 3MF Mesh geometry editor for 3D printing cli-anything-3mf numpy, scipy, trimesh✅ 50?? 50
Total✅ 2,330?? 2,330
-> **100% pass rate** across all 2,330 tests — 1,732 unit tests + 579 end-to-end tests + 19 Node.js tests. +> **100% pass rate** across all 2,330 tests ?? 1,732 unit tests + 579 end-to-end tests + 19 Node.js tests. --- -## 📊 Test Results +## ? Test Results Each CLI harness undergoes rigorous multi-layered testing to ensure production reliability: | Layer | What it tests | Example | |-------|---------------|---------| -| **Unit tests** | Every core function in isolation with synthetic data | `test_core.py` — project creation, layer ops, filter params | +| **Unit tests** | Every core function in isolation with synthetic data | `test_core.py` ?? project creation, layer ops, filter params | | **E2E tests (native)** | Project file generation pipeline | Valid ODF ZIP structure, correct MLT XML, SVG well-formedness | -| **E2E tests (true backend)** | Real software invocation + output verification | LibreOffice → PDF with `%PDF-` magic bytes, Blender → rendered PNG | -| **CLI subprocess tests** | Installed command via `subprocess.run` | `cli-anything-gimp --json project new` → valid JSON output | +| **E2E tests (true backend)** | Real software invocation + output verification | LibreOffice ?? PDF with `%PDF-` magic bytes, Blender ?? rendered PNG | +| **CLI subprocess tests** | Installed command via `subprocess.run` | `cli-anything-gimp --json project new` ?? valid JSON output | ``` ================================ Test Summary ================================ -gimp 107 passed ✅ (64 unit + 43 e2e) -blender 208 passed ✅ (150 unit + 58 e2e) -inkscape 202 passed ✅ (148 unit + 54 e2e) -audacity 161 passed ✅ (107 unit + 54 e2e) -libreoffice 158 passed ✅ (89 unit + 69 e2e) -mubu 96 passed ✅ (85 unit + 11 e2e) -obs-studio 153 passed ✅ (116 unit + 37 e2e) -nslogger 139 passed ✅ (97 unit + 42 e2e) -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) -comfyui 70 passed ✅ (60 unit + 10 e2e) -adguardhome 36 passed ✅ (24 unit + 12 e2e) -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) -lldb 27 passed ✅ (23 unit + 4 e2e) -nsight-graphics 51 passed ✅ (46 unit/CLI + 5 local e2e) -unrealinsights 50 passed ✅ (49 unit + 1 e2e, 9 backend-gated e2e skipped) -cloudanalyzer 14 passed ✅ (7 unit + 7 e2e) -3mf 50 passed ✅ (50 unit) -joplin 118 passed ✅ (91 unit + 27 e2e, 1 skipped on Windows) -────────────────────────────────────────────────────────────────────────────── -TOTAL 2,448 passed ✅ 100% pass rate +gimp 107 passed ?? (64 unit + 43 e2e) +blender 208 passed ?? (150 unit + 58 e2e) +inkscape 202 passed ?? (148 unit + 54 e2e) +audacity 161 passed ?? (107 unit + 54 e2e) +libreoffice 158 passed ?? (89 unit + 69 e2e) +mubu 96 passed ?? (85 unit + 11 e2e) +obs-studio 153 passed ?? (116 unit + 37 e2e) +nslogger 139 passed ?? (97 unit + 42 e2e) +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) +comfyui 70 passed ?? (60 unit + 10 e2e) +adguardhome 36 passed ?? (24 unit + 12 e2e) +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) +lldb 27 passed ?? (23 unit + 4 e2e) +nsight-graphics 51 passed ?? (46 unit/CLI + 5 local e2e) +unrealinsights 50 passed ?? (49 unit + 1 e2e, 9 backend-gated e2e skipped) +cloudanalyzer 14 passed ?? (7 unit + 7 e2e) +3mf 50 passed ?? (50 unit) +joplin 123 passed ?? (96 unit + 27 e2e, 1 skipped on Windows) +©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤©¤ +TOTAL 2,453 passed ?? 100% pass rate ``` --- -## 🏗️ CLI-Anything's Architecture +## ??? CLI-Anything's Architecture

CLI-Anything Architecture

-### 🎯 Core Design Principles +### ? Core Design Principles -1. **Authentic Software Integration** — The CLI generates valid project files (ODF, MLT XML, SVG) and delegates to real applications for rendering. **We build structured interfaces TO software, not replacements**. +1. **Authentic Software Integration** ?? The CLI generates valid project files (ODF, MLT XML, SVG) and delegates to real applications for rendering. **We build structured interfaces TO software, not replacements**. -2. **Flexible Interaction Models** — Every CLI operates in dual modes: stateful REPL for interactive agent sessions + subcommand interface for scripting/pipelines. **Run bare command → enter REPL mode**. +2. **Flexible Interaction Models** ?? Every CLI operates in dual modes: stateful REPL for interactive agent sessions + subcommand interface for scripting/pipelines. **Run bare command ?? enter REPL mode**. -3. **Consistent User Experience** — All generated CLIs share unified REPL interface (repl_skin.py) with branded banners, styled prompts, command history, progress indicators, and standardized formatting. +3. **Consistent User Experience** ?? All generated CLIs share unified REPL interface (repl_skin.py) with branded banners, styled prompts, command history, progress indicators, and standardized formatting. -4. **Agent-Native Design** — Built-in --json flag on every command delivers structured data for machine consumption, while human-readable tables serve interactive use. **Agents discover capabilities via standard --help and which commands**. +4. **Agent-Native Design** ?? Built-in --json flag on every command delivers structured data for machine consumption, while human-readable tables serve interactive use. **Agents discover capabilities via standard --help and which commands**. -5. **Zero Compromise Dependencies** — Real software is a hard requirement — no fallbacks, no graceful degradation. **Tests fail (not skip) when backends are missing, ensuring authentic functionality**. +5. **Zero Compromise Dependencies** ?? Real software is a hard requirement ?? no fallbacks, no graceful degradation. **Tests fail (not skip) when backends are missing, ensuring authentic functionality**. --- -## 📂 Project Structure +## ? Project Structure ``` cli-anything/ -├── 📄 README.md # You are here -├── 📁 assets/ # Images and media -│ ├── icon.png # Project icon -│ └── teaser.png # Teaser figure -│ -├── 🔌 cli-anything-plugin/ # The Claude Code plugin -│ ├── HARNESS.md # Methodology SOP (source of truth) -│ ├── README.md # Plugin documentation -│ ├── QUICKSTART.md # 5-minute getting started -│ ├── PUBLISHING.md # Distribution guide -│ ├── repl_skin.py # Unified REPL interface -│ ├── commands/ # Plugin command definitions -│ │ ├── cli-anything.md # Main build command -│ │ ├── refine.md # Expand existing harness coverage -│ │ ├── test.md # Test runner -│ │ └── validate.md # Standards validation -│ └── scripts/ -│ └── setup-cli-anything.sh # Setup script -│ -├── 🤖 codex-skill/ # Codex skill entry point -├── 🎨 gimp/agent-harness/ # GIMP CLI (107 tests) -├── 🧊 blender/agent-harness/ # Blender CLI (208 tests) -├── ✏️ inkscape/agent-harness/ # Inkscape CLI (202 tests) -├── 🎵 audacity/agent-harness/ # Audacity CLI (161 tests) -├── 🌐 browser/agent-harness/ # Browser CLI (DOMShell MCP, new) -├── 📄 libreoffice/agent-harness/ # LibreOffice CLI (158 tests) -├── 📧 mailchimp/agent-harness/ # Mailchimp Marketing API CLI (303 commands, 36 unit tests) -├── 📚 zotero/agent-harness/ # Zotero CLI (new, write import support) -├── 📓 joplin/agent-harness/ # Joplin CLI (118 tests, new) -├── 📖 calibre/agent-harness/ # Calibre CLI (58 tests: 38 unit + 20 E2E) -├── 📝 mubu/agent-harness/ # Mubu CLI (96 tests) -├── 📹 obs-studio/agent-harness/ # OBS Studio CLI (153 tests) -├── 📱 nslogger/agent-harness/ # NSLogger CLI (139 tests) -├── 🎞️ kdenlive/agent-harness/ # Kdenlive CLI (155 tests) -├── 🎬 shotcut/agent-harness/ # Shotcut CLI (154 tests) -├── 📞 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) -├── 📦 sbox/agent-harness/ # s&box CLI (244 tests: 157 unit + 17 orchestrator + 50 e2e + 20 exit-code) -├── 🎨 sketch/agent-harness/ # Sketch CLI (19 tests, Node.js) -├── 🔬 renderdoc/agent-harness/ # RenderDoc CLI (59 tests) -├── 🟩 nsight-graphics/agent-harness/ # Nsight Graphics CLI (51 tests) -├── 🐞 lldb/agent-harness/ # LLDB CLI (27 tests) -├── 📈 unrealinsights/agent-harness/ # Unreal Insights CLI (50 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) -└── 🔩 3MF/agent-harness/ # 3MF Mesh Editor CLI (50+ tests) +©À©¤©¤ ? README.md # You are here +©À©¤©¤ ? assets/ # Images and media +?? ©À©¤©¤ icon.png # Project icon +?? ©¸©¤©¤ teaser.png # Teaser figure +?? +©À©¤©¤ ? cli-anything-plugin/ # The Claude Code plugin +?? ©À©¤©¤ HARNESS.md # Methodology SOP (source of truth) +?? ©À©¤©¤ README.md # Plugin documentation +?? ©À©¤©¤ QUICKSTART.md # 5-minute getting started +?? ©À©¤©¤ PUBLISHING.md # Distribution guide +?? ©À©¤©¤ repl_skin.py # Unified REPL interface +?? ©À©¤©¤ commands/ # Plugin command definitions +?? ?? ©À©¤©¤ cli-anything.md # Main build command +?? ?? ©À©¤©¤ refine.md # Expand existing harness coverage +?? ?? ©À©¤©¤ test.md # Test runner +?? ?? ©¸©¤©¤ validate.md # Standards validation +?? ©¸©¤©¤ scripts/ +?? ©¸©¤©¤ setup-cli-anything.sh # Setup script +?? +©À©¤©¤ ??? codex-skill/ # Codex skill entry point +©À©¤©¤ ? gimp/agent-harness/ # GIMP CLI (107 tests) +©À©¤©¤ ??? blender/agent-harness/ # Blender CLI (208 tests) +©À©¤©¤ ?? inkscape/agent-harness/ # Inkscape CLI (202 tests) +©À©¤©¤ ? audacity/agent-harness/ # Audacity CLI (161 tests) +©À©¤©¤ ? browser/agent-harness/ # Browser CLI (DOMShell MCP, new) +©À©¤©¤ ? libreoffice/agent-harness/ # LibreOffice CLI (158 tests) +©À©¤©¤ ? mailchimp/agent-harness/ # Mailchimp Marketing API CLI (303 commands, 36 unit tests) +©À©¤©¤ ? zotero/agent-harness/ # Zotero CLI (new, write import support) +©À©¤©¤ ? joplin/agent-harness/ # Joplin CLI (118 tests, new) +©À©¤©¤ ? calibre/agent-harness/ # Calibre CLI (58 tests: 38 unit + 20 E2E) +©À©¤©¤ ? mubu/agent-harness/ # Mubu CLI (96 tests) +©À©¤©¤ ? obs-studio/agent-harness/ # OBS Studio CLI (153 tests) +©À©¤©¤ ? nslogger/agent-harness/ # NSLogger CLI (139 tests) +©À©¤©¤ ??? kdenlive/agent-harness/ # Kdenlive CLI (155 tests) +©À©¤©¤ ? shotcut/agent-harness/ # Shotcut CLI (154 tests) +©À©¤©¤ ? 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) +©À©¤©¤ ? sbox/agent-harness/ # s&box CLI (244 tests: 157 unit + 17 orchestrator + 50 e2e + 20 exit-code) +©À©¤©¤ ? sketch/agent-harness/ # Sketch CLI (19 tests, Node.js) +©À©¤©¤ ? renderdoc/agent-harness/ # RenderDoc CLI (59 tests) +©À©¤©¤ ? nsight-graphics/agent-harness/ # Nsight Graphics CLI (51 tests) +©À©¤©¤ ? lldb/agent-harness/ # LLDB CLI (27 tests) +©À©¤©¤ ? unrealinsights/agent-harness/ # Unreal Insights CLI (50 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) +©¸©¤©¤ ? 3MF/agent-harness/ # 3MF Mesh Editor CLI (50+ tests) ``` Each `agent-harness/` contains an installable Python package under `cli_anything./` with Click CLI, core modules, utils (including `repl_skin.py` and backend wrapper), and comprehensive tests. --- -## 🎯 Plugin Commands +## ? Plugin Commands | Command | Description | |---------|-------------| -| `/cli-anything ` | Build complete CLI harness — all 7 phases | -| `/cli-anything:refine [focus]` | Refine an existing harness — expand coverage with gap analysis | +| `/cli-anything ` | Build complete CLI harness ?? all 7 phases | +| `/cli-anything:refine [focus]` | Refine an existing harness ?? expand coverage with gap analysis | | `/cli-anything:test ` | Run tests and update TEST.md with results | | `/cli-anything:validate ` | Validate against HARNESS.md standards | @@ -1276,7 +1276,7 @@ Each `agent-harness/` contains an installable Python package under `cli_anything # Build from a GitHub repo /cli-anything https://github.com/blender/blender -# Refine an existing harness — broad gap analysis +# Refine an existing harness ?? broad gap analysis /cli-anything:refine /home/user/gimp # Refine with a specific focus area @@ -1291,25 +1291,25 @@ Each `agent-harness/` contains an installable Python package under `cli_anything --- -## 🎮 Demo: Using a Generated CLI +## ? Demo: Using a Generated CLI Here's what an agent can do with `cli-anything-libreoffice`: ```bash # Create a new Writer document $ cli-anything-libreoffice document new -o report.json --type writer -✓ Created Writer document: report.json +?? Created Writer document: report.json # Add content $ cli-anything-libreoffice --project report.json writer add-heading -t "Q1 Report" --level 1 -✓ Added heading: "Q1 Report" +?? Added heading: "Q1 Report" $ cli-anything-libreoffice --project report.json writer add-table --rows 4 --cols 3 -✓ Added 4×3 table +?? Added 4¡Á3 table # Export to real PDF via LibreOffice headless $ cli-anything-libreoffice --project report.json export render output.pdf -p pdf --overwrite -✓ Exported: output.pdf (42,831 bytes) via libreoffice-headless +?? Exported: output.pdf (42,831 bytes) via libreoffice-headless # JSON mode for agent consumption $ cli-anything-libreoffice --json document info --project report.json @@ -1326,27 +1326,27 @@ $ cli-anything-libreoffice --json document info --project report.json ``` $ cli-anything-blender -╔══════════════════════════════════════════╗ -║ cli-anything-blender v1.0.0 ║ -║ Blender CLI for AI Agents ║ -╚══════════════════════════════════════════╝ +¨X¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨[ +?? cli-anything-blender v1.0.0 ?? +?? Blender CLI for AI Agents ?? +¨^¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨T¨a blender> scene new --name ProductShot -✓ Created scene: ProductShot +?? Created scene: ProductShot blender[ProductShot]> object add-mesh --type cube --location 0 0 1 -✓ Added mesh: Cube at (0, 0, 1) +?? Added mesh: Cube at (0, 0, 1) blender[ProductShot]*> render execute --output render.png --engine CYCLES -✓ Rendered: render.png (1920×1080, 2.3 MB) via blender --background +?? Rendered: render.png (1920¡Á1080, 2.3 MB) via blender --background blender[ProductShot]> exit -Goodbye! 👋 +Goodbye! ? ``` --- -## 📖 The Standard Playbook: HARNESS.md +## ? The Standard Playbook: HARNESS.md HARNESS.md is our definitive SOP for making any software agent-accessible via automated CLI generation. @@ -1358,17 +1358,17 @@ The playbook distills key insights from successfully building all 18 diverse, pr | Lesson | Description | |--------|-------------| -| **Use the real software** | The CLI MUST call the actual application for rendering. No Pillow replacements for GIMP, no custom renderers for Blender. Generate valid project files → invoke the real backend. | -| **The Rendering Gap** | GUI apps apply effects at render time. If your CLI manipulates project files but uses a naive export tool, effects get silently dropped. Solution: native renderer → filter translation → render script. | -| **Filter Translation** | When mapping effects between formats (MLT → ffmpeg), watch for duplicate filter merging, interleaved stream ordering, parameter space differences, and unmappable effects. | -| **Timecode Precision** | Non-integer frame rates (29.97fps) cause cumulative rounding. Use `round()` not `int()`, integer arithmetic for display, and ±1 frame tolerance in tests. | +| **Use the real software** | The CLI MUST call the actual application for rendering. No Pillow replacements for GIMP, no custom renderers for Blender. Generate valid project files ?? invoke the real backend. | +| **The Rendering Gap** | GUI apps apply effects at render time. If your CLI manipulates project files but uses a naive export tool, effects get silently dropped. Solution: native renderer ?? filter translation ?? render script. | +| **Filter Translation** | When mapping effects between formats (MLT ?? ffmpeg), watch for duplicate filter merging, interleaved stream ordering, parameter space differences, and unmappable effects. | +| **Timecode Precision** | Non-integer frame rates (29.97fps) cause cumulative rounding. Use `round()` not `int()`, integer arithmetic for display, and ¡À1 frame tolerance in tests. | | **Output Verification** | Never trust that export worked because it exited 0. Verify: magic bytes, ZIP/OOXML structure, pixel analysis, audio RMS levels, duration checks. | > See the full methodology: [`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md) --- -## 📦 Installation & Usage +## ? Installation & Usage ### For Plugin Users (Claude Code) @@ -1410,20 +1410,20 @@ CLI_ANYTHING_FORCE_INSTALLED=1 python3 -m pytest cli_anything//tests/ --- -## 🤝 Contributing +## ??? Contributing We welcome contributions! CLI-Anything is designed to be extensible: -- **New software targets** — Use the plugin to generate a CLI for any software with a codebase, then submit your harness via [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md). -- **Methodology improvements** — PRs to `HARNESS.md` that encode new lessons learned -- **Plugin enhancements** — New commands, phase improvements, better validation -- **Test coverage** — More E2E scenarios, edge cases, workflow tests +- **New software targets** ?? Use the plugin to generate a CLI for any software with a codebase, then submit your harness via [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md). +- **Methodology improvements** ?? PRs to `HARNESS.md` that encode new lessons learned +- **Plugin enhancements** ?? New commands, phase improvements, better validation +- **Test coverage** ?? More E2E scenarios, edge cases, workflow tests ### Limitations -- **Requires strong foundation models** — CLI-Anything relies on frontier-class models (e.g., Claude Opus 4.6, Claude Sonnet 4.6, GPT-5.4) for reliable harness generation. Weaker or smaller models may produce incomplete or incorrect CLIs that require significant manual correction. -- **Relies on available source code** — The 7-phase pipeline analyzes and generates from source code. When the target software only provides compiled binaries that require decompilation, harness quality and coverage will degrade substantially. -- **May require iterative refinement** — A single `/cli-anything` run may not fully cover all capabilities. Running `/refine` one or more times is often needed to push the CLI's performance and coverage to production quality. +- **Requires strong foundation models** ?? CLI-Anything relies on frontier-class models (e.g., Claude Opus 4.6, Claude Sonnet 4.6, GPT-5.4) for reliable harness generation. Weaker or smaller models may produce incomplete or incorrect CLIs that require significant manual correction. +- **Relies on available source code** ?? The 7-phase pipeline analyzes and generates from source code. When the target software only provides compiled binaries that require decompilation, harness quality and coverage will degrade substantially. +- **May require iterative refinement** ?? A single `/cli-anything` run may not fully cover all capabilities. Running `/refine` one or more times is often needed to push the CLI's performance and coverage to production quality. ### Roadmap @@ -1436,24 +1436,24 @@ We welcome contributions! CLI-Anything is designed to be extensible: --- -## 📖 Documentation +## ? Documentation | Document | Description | |----------|-------------| -| [`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md) | The methodology SOP — single source of truth | -| [`cli-anything-plugin/README.md`](cli-anything-plugin/README.md) | Plugin documentation — commands, options, phases | +| [`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md) | The methodology SOP ?? single source of truth | +| [`cli-anything-plugin/README.md`](cli-anything-plugin/README.md) | Plugin documentation ?? commands, options, phases | | [`cli-anything-plugin/QUICKSTART.md`](cli-anything-plugin/QUICKSTART.md) | 5-minute getting started guide | | [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md) | Distribution and publishing guide | Each generated harness also includes: -- `.md` — Architecture SOP specific to that application -- `tests/TEST.md` — Test plan and results documentation +- `.md` ?? Architecture SOP specific to that application +- `tests/TEST.md` ?? Test plan and results documentation --- -## ⭐ Star History +## ?? Star History -If CLI-Anything helps make your software Agent-native, give us a star! ⭐ +If CLI-Anything helps make your software Agent-native, give us a star! ??
@@ -1467,15 +1467,15 @@ If CLI-Anything helps make your software Agent-native, give us a star! ⭐ --- -## 📄 License +## ? License -Apache License 2.0 — free to use, modify, and distribute. +Apache License 2.0 ?? free to use, modify, and distribute. ---
-**CLI-Anything** — *Make any software with a codebase Agent-native.* +**CLI-Anything** ?? *Make any software with a codebase Agent-native.* A methodology for the age of AI agents | 18 professional software demos | 2,280 passing tests @@ -1486,6 +1486,6 @@ Apache License 2.0 — free to use, modify, and distribute.

- Thanks for visiting ✨ CLI-Anything!

+ Thanks for visiting ?? CLI-Anything!

Views

diff --git a/README_CN.md b/README_CN.md index 0da2357d7..3b8cb8cac 100644 --- a/README_CN.md +++ b/README_CN.md @@ -1,30 +1,30 @@ -

  CLI-Anything: 让所有软件都能被 Agent 驱动

+

  CLI-Anything: ???????????????? Agent ????

- 今天的软件为人而生👨‍💻,明天的用户是 Agent🤖
-CLI-Anything:连接 AI Agent 与全世界软件的桥梁

+ ????????????????????????????????????????????? Agent????
+CLI-Anything??????? AI Agent ?????????????????

-**🌐 [CLI-Hub](https://hkuds.github.io/CLI-Anything/)**:在 **[CLI-Hub](https://hkuds.github.io/CLI-Anything/)** 探索社区已构建的所有 CLI,一条命令即可安装。想贡献你的 CLI?[提交 PR](https://github.com/HKUDS/CLI-Anything/blob/main/CONTRIBUTING.md) — Hub 会即时更新。 +**???? [CLI-Hub](https://hkuds.github.io/CLI-Anything/)**????? **[CLI-Hub](https://hkuds.github.io/CLI-Anything/)** ?????????????????????? CLI????????????????????????????? CLI??[?? PR](https://github.com/HKUDS/CLI-Anything/blob/main/CONTRIBUTING.md) ??? Hub ???????????????

- Quick Start - Demos - Tests + Quick Start + Demos + Tests License

- Python - Click + Python + Click Pytest Coverage Output - Feishu -WeChat + Feishu +WeChat

-**一行命令**,让任意软件接入 OpenClaw、nanobot、Cursor、Claude Code 等 Agent 框架。 +**????????**??????????????? OpenClaw???nanobot???Cursor???Claude Code ?? Agent ????????

CLI-Anything typing demo @@ -36,118 +36,118 @@ CLI-Anything:连接 AI Agent 与全世界软件的桥梁
--- -## 🤔 为什么是 CLI? +## ???? ???????? CLI?? -CLI 是人类和 AI Agent 共通的万能接口: +CLI ???????? AI Agent ???????????????????? -• **结构化、可组合** - 文本命令天然匹配 LLM 的输入格式,可自由串联成复杂工作流 +??? **????????????????** - ???????????????????? LLM ???????????????????????????????? -• **轻量且通用** - 几乎零开销,跨平台运行,不依赖额外环境 +??? **????????????** - ??????????????????????????????????? -• **自描述** - 一个 `--help` 就能让 Agent 自动发现所有功能 +??? **?????** - ??? `--help` ????? Agent ??????????????????????? -• **久经验证** - Claude Code 每天通过 CLI 执行数以千计的真实任务 +??? **??????** - Claude Code ??????? CLI ???????????????????????? -• **Agent 友好** - 结构化 JSON 输出,Agent 无需任何额外解析 +??? **Agent ???** - ???????? JSON ???????Agent ???????????????? -• **确定且可靠** - 输出稳定一致,Agent 行为可预测 +??? **???????** - ???????????????Agent ???????? -## 🚀 快速上手 +## ???? ????????? -### 环境要求 +### ???????? - **Python 3.10+** -- 目标软件已安装(如 GIMP、Blender、LibreOffice 或你自己的应用) -- 支持的 AI 编程工具之一:[Claude Code](#-claude-code) | [OpenClaw](#-openclaw) | [OpenCode](#-opencode) | [Codex](#-codex) | [Qodercli](#-qodercli) | [GitHub Copilot CLI](#-github-copilot-cli) | [更多平台](#-更多平台即将支持) +- ???????????????? GIMP???Blender???LibreOffice ?????????????????? +- ????????? AI ??????????????[Claude Code](#-claude-code) | [OpenClaw](#-openclaw) | [OpenCode](#-opencode) | [Codex](#-codex) | [Qodercli](#-qodercli) | [GitHub Copilot CLI](#-github-copilot-cli) | [???????](#-????????????????) -### 选择你的平台 +### ????????????

-

⚡ Claude Code

+

??? Claude Code

-**第一步:添加插件市场** +**??????????????????** -CLI-Anything 以 Claude Code 插件市场的形式托管在 GitHub 上。 +CLI-Anything ? Claude Code ???????????????????? GitHub ????? ```bash -# 添加 CLI-Anything 插件市场 +# ???? CLI-Anything ???????? /plugin marketplace add HKUDS/CLI-Anything ``` -**第二步:安装插件** +**?????????????** ```bash -# 从市场安装 cli-anything 插件 +# ??????????? cli-anything ??? /plugin install cli-anything ``` -搞定。插件已经在你的 Claude Code 会话中可用了。 +??????????????????? Claude Code ????????????? -**Windows 注意:** Claude Code 通过 `bash` 执行命令。Windows 下请安装 Git for Windows(包含 `bash` 和 `cygpath`) -或使用 WSL,否则可能出现 `cygpath: command not found`。 +**Windows ??????** Claude Code ????? `bash` ????????????Windows ??????? Git for Windows?????? `bash` ??? `cygpath`?? +??????? WSL???????????????? `cygpath: command not found`??? -**第三步:一行命令生成 CLI** +**???????????????????? CLI** ```bash -# /cli-anything <软件路径或仓库地址> -# 为 GIMP 生成完整的 CLI(7 个阶段全自动) +# /cli-anything +# ? GIMP ?????????????? CLI??7 ???????????????? /cli-anything ./gimp -# 兼容写法(旧版本 Claude Code 可重试) +# ???????????????????? Claude Code ???????? # /cli-anything:cli-anything ./gimp ``` -Claude Code 不同版本的命令兼容说明: -- 优先使用 `/cli-anything` 作为主入口。 -- 在已**确认插件已安装并加载**的情况下,若旧版本的 Claude Code 不识别 `/cli-anything`,可尝试兼容写法 `/cli-anything:cli-anything`。 -- 其他辅助命令保持 `:子命令` 形式(例如 `/cli-anything:refine`)。 +Claude Code ?????????????????????????? +- ????????? `/cli-anything` ??????????? +- ????**???????????????**???????????????????????????? Claude Code ?????? `/cli-anything`??????????????? `/cli-anything:cli-anything`??? +- ?????????????????? `:?????` ???????? `/cli-anything:refine`????? -如果出现 `Unknown skill: cli-anything`,两种写法都引用同一个 skill 名称,切换写法无法解决,请优先排查插件是否已安装/加载: -1. 重新加载插件命令:`/reload-plugins` -2. 验证插件是否已加载:`/help cli-anything`(能看到 CLI-Anything 帮助即表示已加载) -3. 如仍未识别,重新从市场安装: +??????????? `Unknown skill: cli-anything`?????????????????????? skill ????????????????????????????????????????????????/?????? +1. ???????????????????`/reload-plugins` +2. ?????????????????`/help cli-anything`??????????? CLI-Anything ?????????????? +3. ???????????????????????????????? - `/plugin marketplace add HKUDS/CLI-Anything` - `/plugin install cli-anything` -4. 确认插件可用后,再重试入口命令: - - 推荐:`/cli-anything ./gimp` - - 仅旧版本:`/cli-anything:cli-anything ./gimp` +4. ??????????????????????????????? + - ??????`/cli-anything ./gimp` + - ?????????????`/cli-anything:cli-anything ./gimp` -完整流水线自动执行: -1. 🔍 **分析** — 扫描源码,将 GUI 操作映射到 API -2. 📐 **设计** — 规划命令分组、状态模型、输出格式 -3. 🔨 **实现** — 构建 Click CLI,包含 REPL、JSON 输出、撤销/重做 -4. 📋 **规划测试** — 生成 TEST.md,涵盖单元测试和端到端测试计划 -5. 🧪 **编写测试** — 实现完整测试套件 -6. 📝 **文档** — 更新 TEST.md,写入测试结果 -7. 📦 **发布** — 生成 `setup.py`,安装到 PATH +????????????????????? +1. ???? **??????** ??? ?????????? GUI ????????????? API +2. ???? **??** ??? ????????????????????????????????????? +3. ???? **?????** ??? ???? Click CLI?????? REPL???JSON ??????????????/????? +4. ???? **?????????** ??? ?????? TEST.md??????????????????????????????? +5. ???? **?????????** ??? ????????????????? +6. ???? **????** ??? ?????? TEST.md????????????????? +7. ???? **????** ??? ?????? `setup.py`????????? PATH -**第四步(可选):优化和扩展 CLI** +**???????????????????????????? CLI** -初始构建完成后,你可以迭代优化 CLI,扩展覆盖面并补充缺失的功能: +???????????????????????????? CLI??????????????????????????????? ```bash -# 全面优化 — Agent 分析所有功能的覆盖差距 +# ????????? ??? Agent ???????????????????????????? /cli-anything:refine ./gimp -# 定向优化 — 指定特定功能领域 -/cli-anything:refine ./gimp "我需要更多图像批处理和滤镜相关的 CLI" +# ????????? ??? ????????????????????? +/cli-anything:refine ./gimp "????????????????????????????????????????? CLI" ``` -优化命令会对软件的完整功能与当前 CLI 覆盖范围进行差距分析,然后为识别到的差距实现新命令、测试和文档。你可以多次运行该命令,逐步扩大功能覆盖范围 — 每次运行都是增量的、非破坏性的。 +??????????????????????????????????? CLI ?????????????????????????????????????????????????????????????????????????????????????????????????????????????????? ??? ???????????????????????????????????
-备选方案:手动安装 +?????????????????????? -如果你不想用插件市场: +??????????????????????? ```bash -# 克隆仓库 +# ?????????? git clone https://github.com/HKUDS/CLI-Anything.git -# 复制插件到 Claude Code 插件目录 +# ?????????? Claude Code ???????? cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything -# 重新加载插件 +# ????????????? /reload-plugins ``` @@ -156,84 +156,84 @@ cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything
-

⚡ OpenCode (实验性支持)

+

??? OpenCode ?????????????????

-**第一步:安装命令** +**??????????????** -**注意:** 请升级到最新 OpenCode,旧版本可能使用不同的命令目录路径。 +**??????** ????????????? OpenCode???????????????????????????????????????? -将 CLI-Anything 命令**和** `HARNESS.md` 复制到 OpenCode 命令目录: +?? CLI-Anything ????**???** `HARNESS.md` ??????? OpenCode ??????????? ```bash -# 克隆仓库 +# ?????????? git clone https://github.com/HKUDS/CLI-Anything.git -# 全局安装(所有项目可用) +# ??????????????????????????? cp CLI-Anything/opencode-commands/*.md ~/.config/opencode/commands/ cp CLI-Anything/cli-anything-plugin/HARNESS.md ~/.config/opencode/commands/ -# 或项目级安装 +# ???????????? cp CLI-Anything/opencode-commands/*.md .opencode/commands/ cp CLI-Anything/cli-anything-plugin/HARNESS.md .opencode/commands/ ``` -> **注意:** `HARNESS.md` 是所有命令引用的方法论规范,必须和命令文件放在同一目录下。 +> **??????** `HARNESS.md` ???????????????????????????????????????????????????????????????????? -安装后获得 5 个斜杠命令:`/cli-anything`、`/cli-anything-refine`、`/cli-anything-test`、`/cli-anything-validate` 和 `/cli-anything-list`。 +??????????? 5 ???????????`/cli-anything`???`/cli-anything-refine`???`/cli-anything-test`???`/cli-anything-validate` ??? `/cli-anything-list`??? -**第二步:一行命令生成 CLI** +**???????????????????? CLI** ```bash -# 为 GIMP 生成完整的 CLI(7 个阶段全自动) +# ? GIMP ?????????????? CLI??7 ???????????????? /cli-anything ./gimp -# 从 GitHub 仓库构建 +# ?? GitHub ???????? /cli-anything https://github.com/blender/blender ``` -命令以子任务方式运行,遵循与 Claude Code 相同的 7 阶段方法论。 +??????????????????????? Claude Code ???????? 7 ????????????? -**第三步(可选):优化和扩展 CLI** +**??????????????????????????? CLI** ```bash -# 全面优化 — Agent 分析所有功能的覆盖差距 +# ????????? ??? Agent ???????????????????????????? /cli-anything-refine ./gimp -# 定向优化 — 指定特定功能领域 -/cli-anything-refine ./gimp "批处理和滤镜" +# ????????? ??? ????????????????????? +/cli-anything-refine ./gimp "??????????????" ```
-

⚡ Qodercli 社区贡献

+

??? Qodercli ????????

-**第一步:注册插件** +**?????????????** ```bash git clone https://github.com/HKUDS/CLI-Anything.git bash CLI-Anything/qoder-plugin/setup-qodercli.sh ``` -脚本会将 cli-anything 插件注册到 `~/.qoder.json`。注册后开启新的 Qodercli 会话即可使用。 +?????????? cli-anything ?????????? `~/.qoder.json`?????????????????? Qodercli ???????????? -**第二步:在 Qodercli 中使用 CLI-Anything** +**????????? Qodercli ????? CLI-Anything** ```bash /cli-anything:cli-anything ./gimp -/cli-anything:refine ./gimp "批处理和滤镜" +/cli-anything:refine ./gimp "??????????????" /cli-anything:validate ./gimp ```
-

⚡ OpenClaw

+

??? OpenClaw

-**第一步:安装 Skill** +**?????????? Skill** -CLI-Anything 提供了原生的 OpenClaw `SKILL.md` 文件。请将其复制到你的 OpenClaw 技能目录: +CLI-Anything ?????????????? OpenClaw `SKILL.md` ???????????????????????? OpenClaw ????????????? ```bash # Clone the repo @@ -244,45 +244,45 @@ mkdir -p ~/.openclaw/skills/cli-anything cp CLI-Anything/openclaw-skill/SKILL.md ~/.openclaw/skills/cli-anything/SKILL.md ``` -**第二步:构建 CLI** +**?????????? CLI** -安装完成后,你就可以在 OpenClaw 中直接调用: +???????????????????? OpenClaw ?????????????? `@cli-anything build a CLI for ./gimp` -该技能采用了与 Claude Code 和 OpenCode 一致的 7 步构建流程。 +????????????????? Claude Code ??? OpenCode ???????? 7 ???????????
-

⚡ Codex 实验性 社区贡献

+

??? Codex ??????? ????????

-**第一步:安装 Skill** +**?????????? Skill** -运行仓库内置的安装脚本: +?????????????????????????? ```bash -# 克隆仓库 +# ?????????? git clone https://github.com/HKUDS/CLI-Anything.git -# 安装 skill +# ???? skill bash CLI-Anything/codex-skill/scripts/install.sh ``` -在 Windows PowerShell 中,可以使用: +??? Windows PowerShell ??????????? ```powershell .\CLI-Anything\codex-skill\scripts\install.ps1 ``` -脚本会把 skill 安装到 `$CODEX_HOME/skills/cli-anything`;如果没有设置 `CODEX_HOME`,则默认安装到 `~/.codex/skills/cli-anything`。 +??????????? skill ??????? `$CODEX_HOME/skills/cli-anything`????????????? `CODEX_HOME`??????????????? `~/.codex/skills/cli-anything`??? -安装后重启 Codex,让它重新发现这个 skill。 +?????????? Codex??????????????????? skill??? -**第二步:在 Codex 里使用 CLI-Anything** +**????????? Codex ??????? CLI-Anything** -直接用自然语言描述任务,例如: +???????????????????????????????? ```text Use CLI-Anything to build a harness for ./gimp @@ -290,16 +290,16 @@ Use CLI-Anything to refine ./shotcut for picture-in-picture workflows Use CLI-Anything to validate ./libreoffice ``` -这个 Codex skill 复用了 Claude Code 插件和 OpenCode 命令所使用的同一套方法论, -不会改变生成出来的 Python harness 结构。 +??? Codex skill ?????? Claude Code ?????? OpenCode ???????????????????????????? +????????????????????? Python harness ????????
-

⚡ GitHub Copilot CLI 社区贡献

+

??? GitHub Copilot CLI ????????

-**第一步:安装插件** +**?????????????** ```bash git clone https://github.com/HKUDS/CLI-Anything.git @@ -307,116 +307,116 @@ cd CLI-Anything copilot plugin install ./cli-anything-plugin ``` -这将 CLI-Anything 插件安装到 GitHub Copilot CLI 中。插件应该已经在你的 GitHub Copilot CLI 会话中可用了。 +???? CLI-Anything ?????????? GitHub Copilot CLI ??????????????????? GitHub Copilot CLI ????????????? -**第二步:在 GitHub Copilot CLI 中使用 CLI-Anything** +**????????? GitHub Copilot CLI ????? CLI-Anything** ```bash /cli-anything:cli-anything ./gimp -/cli-anything:refine ./gimp "批处理和滤镜" +/cli-anything:refine ./gimp "??????????????" /cli-anything:validate ./gimp ```
-

🔮 更多平台(即将支持)

+

???? ????????????????????

-CLI-Anything 的设计是平台无关的,计划支持更多 AI 编程工具: +CLI-Anything ???????????????????????????????????? AI ?????????? -- **Codex** — 已通过 `codex-skill/` 提供接入 -- **Cursor** — 即将支持 -- **Windsurf** — 即将支持 -- **你喜欢的工具** — 欢迎贡献!参考 `opencode-commands/` 目录的实现。 +- **Codex** ??? ?????? `codex-skill/` ????????? +- **Cursor** ??? ????????? +- **Windsurf** ??? ????????? +- **????????????** ??? ????????????? `opencode-commands/` ????????????????
-### 开始使用生成的 CLI +### ????????????????? CLI -无论你用哪个平台构建,生成的 CLI 使用方式完全一样: +????????????????????????????? CLI ?????????????????? ```bash -# 安装到 PATH +# ??????? PATH cd gimp/agent-harness && pip install -e . -# 随处可用 +# ????????? cli-anything-gimp --help cli-anything-gimp project new --width 1920 --height 1080 -o poster.json cli-anything-gimp --json layer add -n "Background" --type solid --color "#1a1a2e" -# 进入交互式 REPL +# ????????? REPL cli-anything-gimp ``` --- -## 💡 CLI-Anything 的愿景:构建 Agent 原生的软件生态 +## ???? CLI-Anything ??????????????? Agent ????????????????? -• 🌐 **无门槛接入** - 任何软件都能通过结构化 CLI 即刻被 Agent 操控。 +??? ???? **??????????????** - ???????????????????????? CLI ????? Agent ????????? -• 🔗 **无缝集成** - 不需要专门的 API、不需要操控 GUI、不需要重构代码,也不需要复杂的适配层。 +??? ???? **??????????** - ????????????? API?????????????? GUI?????????????????????????????????????????? -• 🚀 **面向未来** - 一条命令,就能把为人类设计的软件变成 Agent 的原生工具。 +??? ???? **???????** - ??????????????????????????????? Agent ???????????????? --- -## 🔧 适用场景 +## ???? ???????????? -| 类别 | 如何接入 Agent | 典型软件 | +| ???? | ?????????? Agent | ???????? | |------|--------------|---------| -| **📂 GitHub 开源项目** | 通过自动生成 CLI,将任意开源项目转化为 Agent 可控工具 | VSCodium、WordPress、Calibre、Zotero、Joplin、Logseq、Penpot、Super Productivity | -| **🤖 AI/ML 平台** | 用结构化命令驱动模型训练、推理流水线和超参搜索 | Stable Diffusion WebUI、ComfyUI、InvokeAI、Text-generation-webui、Open WebUI、Fooocus、Kohya_ss、AnythingLLM、SillyTavern | -| **📊 数据与分析** | 以编程方式完成数据处理、可视化和统计分析工作流 | JupyterLab、Apache Superset、Metabase、Redash、DBeaver、KNIME、Orange、OpenSearch Dashboards、Lightdash | -| **💻 开发工具** | 通过 CLI 串联代码编辑、构建、测试与部署流程 | Jenkins、Gitea、Hoppscotch、Portainer、pgAdmin、SonarQube、ArgoCD、OpenLens、Insomnia、Beekeeper Studio | -| **🎨 创意与媒体** | 以编程方式控制内容创作、编辑和渲染工作流 | Blender、GIMP、OBS Studio、Audacity、Krita、Kdenlive、Shotcut、Inkscape、Darktable、LMMS、Ardour | -| **📐 图表与可视化** | 以编程方式创建和操作流程图、架构图、ER 图等各类图表 | Draw.io (diagrams.net)、Mermaid、PlantUML、Excalidraw、yEd | -| **🔬 科学计算** | 自动化科研工作流、仿真模拟和复杂计算 | ImageJ、FreeCAD、QGIS、ParaView、Gephi、LibreCAD、Stellarium、KiCad、JASP、Jamovi | -| **🏢 企业与办公** | 将商业应用和生产力工具转化为 Agent 可访问的系统 | NextCloud、GitLab、Grafana、Mattermost、LibreOffice、AppFlowy、NocoDB、Odoo (Community)、Plane、ERPNext | -| **📞 通信与协作** | 通过结构化 CLI 自动化会议调度、参会人管理、录制获取和报告生成 | Zoom、Jitsi Meet、BigBlueButton、Mattermost | +| **???? GitHub ???????** | ????????????????? CLI???????????????????? Agent ???????? | VSCodium???WordPress???Calibre???Zotero???Joplin???Logseq???Penpot???Super Productivity | +| **???? AI/ML ??** | ??????????????????????????????????????????????? | Stable Diffusion WebUI???ComfyUI???InvokeAI???Text-generation-webui???Open WebUI???Fooocus???Kohya_ss???AnythingLLM???SillyTavern | +| **???? ????????????** | ??????????????????????????????????????????????? | JupyterLab???Apache Superset???Metabase???Redash???DBeaver???KNIME???Orange???OpenSearch Dashboards???Lightdash | +| **???? ????????** | ????? CLI ???????????????????????????????? | Jenkins???Gitea???Hoppscotch???Portainer???pgAdmin???SonarQube???ArgoCD???OpenLens???Insomnia???Beekeeper Studio | +| **???? ????????????** | ?????????????????????????????????????????? | Blender???GIMP???OBS Studio???Audacity???Krita???Kdenlive???Shotcut???Inkscape???Darktable???LMMS???Ardour | +| **???? ????????????** | ??????????????????????????????????????????ER ???????????? | Draw.io (diagrams.net)???Mermaid???PlantUML???Excalidraw???yEd | +| **???? ??????** | ????????????????????????????????????? | ImageJ???FreeCAD???QGIS???ParaView???Gephi???LibreCAD???Stellarium???KiCad???JASP???Jamovi | +| **???? ???????????** | ??????????????????????????????? Agent ??????????? | NextCloud???GitLab???Grafana???Mattermost???LibreOffice???AppFlowy???NocoDB???Odoo (Community)???Plane???ERPNext | +| **???? ?????????** | ????????????? CLI ?????????????????????????????????????????????????????? | Zoom???Jitsi Meet???BigBlueButton???Mattermost | --- -## CLI-Anything 的核心优势 +## CLI-Anything ??????????? -### Agent 与软件之间的鸿沟 +### Agent ??????????????? -AI Agent 推理能力很强,但操控真实专业软件的能力很弱。现有方案要么是脆弱的 GUI 自动化,要么是覆盖面有限的 API,要么是阉割了 90% 功能的重新实现。 +AI Agent ?????????????????????????????????????????????????????????????????????????? GUI ???????????????????????????????? API???????????????? 90% ??????????????????????? -**CLI-Anything 的解法**:把任何专业软件变成 Agent 原生工具,功能一个不少。 +**CLI-Anything ??????**??????????????????? Agent ??????????????????????????? -| **现有痛点** | **CLI-Anything 怎么解** | +| **????????????** | **CLI-Anything ??????** | |------------|----------------------| -| 🤖 "AI 用不了真正的专业工具" | 直接对接真实软件后端(Blender、LibreOffice、FFmpeg)—— 完整的专业能力,零妥协 | -| 💸 "GUI 自动化三天两头崩" | 告别截图、点击和 RPA 的脆弱性,纯命令行操控,结构化接口 | -| 📊 "Agent 需要结构化数据" | 内置 JSON 输出供 Agent 直接消费,同时保留可读格式方便调试 | -| 🔧 "定制集成太贵了" | 一个插件就能为任意代码库自动生成 CLI,经过验证的 7 阶段流水线 | -| ⚡ "原型和生产之间差十万八千里" | 1,774+ 测试用例,全部在真实软件上验证通过,覆盖 13 款主流应用 | +| ???? "AI ?????????????????????" | ??????????????????????Blender???LibreOffice???FFmpeg???????? ????????????????????????? | +| ???? "GUI ???????????????" | ???????????????????????? RPA ??????????????????????????????????????? | +| ???? "Agent ????????????????" | ???? JSON ??????? Agent ???????????????????????????????? | +| ???? "???????????????" | ??????????????????????????????? CLI??????????? 7 ??????? | +| ??? "??????????????????????????????" | 1,774+ ???????????????????????????????????????????? 13 ???????? | --- -## 🎯 CLI-Anything 能做什么? +## ???? CLI-Anything ??????????? @@ -424,54 +424,54 @@ CLI-Anything 可直接**替代基于 GUI 的 Agent 方案** —— 无需截图 --- -## ✨ ⚙️ CLI-Anything 的工作方式 +## ??? ???? CLI-Anything ??????????
-### 🛠️ 让 Agent 接管你的工作流 +### ????? ? Agent ???????????? -不管是专业场景还是日常事务 —— 把代码库扔给 `/cli-anything` 就行。GIMP、Blender、Shotcut 搞创作,LibreOffice、OBS Studio 干日常。没有源码?找个开源替代品,照样能用。你会立刻得到一套 Agent 可以直接调用的完整 CLI。 +????????????????????????????? ?????? ???????????? `/cli-anything` ??????GIMP???Blender???Shotcut ?????????LibreOffice???OBS Studio ?????????????????????????????????????????????????????????????? Agent ????????????????????? CLI??? -### 🔗 把散装 API 统一成一个 CLI +### ???? ???????? API ?????????? CLI -受够了一堆零碎的 Web 服务 API?把文档或 SDK 手册喂给 `/cli-anything`,你的 Agent 就能拿到一个**有状态的、功能完整的 CLI**,把那些零散的接口整合成逻辑清晰的命令组。一个工具可替代几十个裸 API 调用 —— 能力更强,token 更省。 +?????????????????? Web ?????? API???????????? SDK ??????????? `/cli-anything`?????? Agent ?????????????**????????????????????????????? CLI**??????????????????????????????????????????????????????????????????????? API ????? ?????? ????????????token ????????? -### 🚀 取代 GUI Agent,或让它更强 +### ???? ??? GUI Agent???????????? -CLI-Anything 可直接**替代基于 GUI 的 Agent 方案** —— 无需截图,也无需繁琐地点击像素操作。更实用的是:只要你对 GUI 软件执行过 `/cli-anything` 命令,就能**全自动生成 Agent 任务、评测器及 Benchmark** —— 全程采用纯代码与终端操作,支持迭代优化,显著提升效率。 +CLI-Anything ???????**????????? GUI ??? Agent ?????** ?????? ????????????????????????????????????????????????????????????????? GUI ????????? `/cli-anything` ??????????**??????????????? Agent ???????????????? Benchmark** ?????? ???????????????????????????????????????????????????????????
@@ -479,348 +479,348 @@ CLI-Anything 可直接**替代基于 GUI 的 Agent 方案** —— 无需截图 --- -## 🎬 实测展示 +## ???? ??????? -### 🎯 通用性 +### ???? ????????? -CLI-Anything 适用于任何有代码库的软件 —— 不限领域,不限架构。 +CLI-Anything ??????????????????????? ?????? ???????????????????????? -### 🏭 专业级测试 +### ???? ????????? -在 13 款复杂应用上进行了实测,涵盖创意、生产力、通信、图表、原生调试、GPU 分析和 AI 内容生成领域 —— 这些软件此前对 AI Agent 来说几乎不可触及。 +??? 13 ?????????????????????????????????????????????????????????????????????????GPU ????????? AI ??????????????? ?????? ??????????? AI Agent ??????????????? -### 🎨 覆盖多元领域 +### ???? ??????????????? -从创意工作流(图像编辑、3D 建模、矢量图形)到生产工具(音频、办公、直播、视频剪辑)。 +???????????????????????????3D ?????????????????????????????????????????????????????????????????????? -### ✅ 完整的 CLI 生成 +### ??? ???????? CLI ?????? -每款软件都生成了完整的、可投产的 CLI 接口 —— 不是 demo,而是保留全部功能的完整工具接入。 +?????????????????????????????????? CLI ???? ?????? ???? demo?????????????????????????????????????????????
-### 🏗️ 全自动 7 阶段流水线 +### ????? ????????? 7 ??????? -从代码分析到发布上线 —— 插件自动完成架构设计、代码实现、测试规划、测试编写和文档生成,全程无需人工介入。 +???????????????????? ?????? ???????????????????????????????????????????????????????????????????????????????????????????? -### 🎯 真实软件集成 +### ???? ????????????? -直接调用真实应用进行渲染。LibreOffice 生成 PDF,Blender 渲染 3D 场景,Audacity 通过 sox 处理音频。**零妥协**,**零玩具实现**。 +????????????????????????????????LibreOffice ?????? PDF??Blender ???? 3D ????????Audacity ????? sox ????????????**?????**??**??????????????**???
-### 🔁 智能会话管理 +### ???? ???????????? -持久化项目状态,支持撤销/重做,加上统一的 REPL 交互界面(ReplSkin),所有 CLI 的使用体验保持一致。 +????????????????????????????????/??????????????????? REPL ?????????ReplSkin?????????? CLI ??????????????????????? -### 📦 零配置安装 +### ???? ??????????? -`pip install -e .` 即可将 cli-anything-<软件名> 装到 PATH。Agent 通过标准的 `which` 命令发现工具,不需要额外配置。 +`pip install -e .` ???? cli-anything- ????? PATH???Agent ????????????? `which` ??????????????????????????????
-### 🧪 生产级测试 +### ???? ????????? -多层验证:使用合成数据的单元测试、使用真实文件和软件的端到端测试,外加已安装命令的 CLI 子进程验证。 +?????????????????????????????????????????????????????????????????????????????????????? CLI ??????????? -### 🐍 干净的包架构 +### ???? ???????????????? -所有 CLI 统一在 cli_anything.* 命名空间下 —— 无冲突、可 pip 安装、命名规范统一:cli-anything-gimp、cli-anything-blender 等。 +?????? CLI ??????? cli_anything.* ?????????? ?????? ??????????? pip ??????????????????????cli-anything-gimp???cli-anything-blender ?????
- - - - - + + + + + - - + + - + - - + + - + - - + + - + - - + + - + - - + + - + - - + + - + - - + + - - + + - - + + - + - - + + - + - - + + - + - - + + - + - - + + - + - - + + - + - - + + - + - - + + - + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - + - - + + - + - - + +
软件领域CLI 命令后端测试???????CLI ???????????
🎨 GIMP图像编辑???? GIMP?????????? cli-anything-gimp Pillow + GEGL/Script-Fu✅ 107??? 107
🧊 Blender3D 建模与渲染???? Blender3D ???????? cli-anything-blender bpy (Python scripting)✅ 208??? 208
✏️ Inkscape矢量图形???? Inkscape?????????? cli-anything-inkscape Direct SVG/XML manipulation✅ 202??? 202
🎵 Audacity音频制作???? Audacity?????????? cli-anything-audacity Python wave + sox✅ 161??? 161
📄 LibreOffice办公套件(Writer、Calc、Impress)???? LibreOffice???????????Writer???Calc???Impress?? cli-anything-libreoffice ODF generation + headless LO✅ 158??? 158
📚 Zotero文献管理与引用???? Zotero???????????????? cli-anything-zotero Local SQLite + connector + Local API✅ 新增??? ?????
📓 Joplin笔记与待办事项???? Joplin????????????? cli-anything-joplinJoplin 终端 CLI 子进程✅ 118Joplin ??? CLI ???????? 118
📹 OBS Studio直播与录制???? OBS Studio????????????? cli-anything-obs-studio JSON scene + obs-websocket✅ 153??? 153
🎞️ Kdenlive视频剪辑????? Kdenlive????????? cli-anything-kdenlive MLT XML + melt renderer✅ 155??? 155
🎬 Shotcut视频剪辑???? Shotcut????????? cli-anything-shotcut Direct MLT XML + melt✅ 154??? 154
🎬 Openscreen屏幕录像编辑器???? Openscreen??????????????? cli-anything-openscreen ffmpeg backend✅ 101??? 101
📞 Zoom视频会议???? Zoom??????? cli-anything-zoom Zoom REST API (OAuth2)✅ 22??? 22
📐 Draw.io图表绘制???? Draw.io????????? cli-anything-drawio mxGraph XML + draw.io CLI✅ 138??? 138
✨ AnyGenAI 内容生成??? AnyGenAI ?????????? cli-anything-anygen AnyGen REST API (anygen.io)✅ 50??? 50
🐞 LLDB原生调试???? LLDB?????????? cli-anything-lldb LLDB Python API✅ 27??? 27
🟩 Nsight Graphics CLIGPU 调试与分析???? Nsight Graphics CLIGPU ???????????? cli-anything-nsight-graphics官方 ngfx / ngfx-capture 编排 + GPU Trace 摘要 + replay 分析✅ 51????? ngfx / ngfx-capture ????? + GPU Trace ???? + replay ????????? 51
📈 Unreal Insights性能分析???? Unreal Insights???????????? cli-anything-unrealinsights后台 trace 会话 + 匹配版 UnrealInsights 构建 + 无头导出✅ 50??? trace ??? + ????????? UnrealInsights ???? + ??????????? 50
📦 s&box游戏开发???? s&box???????? cli-anything-sboxSource 2 游戏引擎 - 直接读写 .scene/.prefab/.vmat/.vsnd JSON✅ 244Source 2 ????????? - ?????????? .scene/.prefab/.vmat/.vsnd JSON??? 244
🎨 SketchUI 设计???? SketchUI ?? sketch-cli sketch-constructor (Node.js)✅ 19??? 19
🔩 3MF3D 打印网格编辑器???? 3MF3D ?????????????? cli-anything-3mf numpy, scipy, trimesh✅ 50+??? 50+
合计✅ 1,824?????? 1,824
-> 全部 1,824 项测试 **100% 通过** - 1,318 项单元测试 + 487 项端到端测试 + 19 项 Node.js 测试。 +> ?????? 1,824 ????? **100% ?????** - 1,318 ?????????? + 487 ?????????? + 19 ? Node.js ??????? --- -## 📊 测试结果 +## ???? ????????? -每个 CLI 都经过多层严格测试,确保生产可用: +?? CLI ?????????????????????????????? -| 测试层级 | 测什么 | 示例 | +| ??????? | ?????? | ??? | |---------|-------|------| -| **单元测试** | 每个核心函数的隔离验证,使用合成数据 | `test_core.py` — 项目创建、图层操作、滤镜参数 | -| **端到端测试(原生)** | 项目文件的完整生成流程 | ODF ZIP 结构合法性、MLT XML 正确性、SVG 格式完整性 | -| **端到端测试(真实后端)** | 调用真实软件并验证输出 | LibreOffice → 含 `%PDF-` 魔术字节的 PDF,Blender → 渲染后的 PNG | -| **CLI 子进程测试** | 通过 `subprocess.run` 调用已安装命令 | `cli-anything-gimp --json project new` → 合法 JSON 输出 | +| **?????????** | ???????????????????????????????????? | `test_core.py` ??? ????????????????????????????????? | +| **???????????????????** | ????????????????????????? | ODF ZIP ???????????????MLT XML ????????SVG ?????????? | +| **?????????????????????** | ????????????????????? | LibreOffice ??? ? `%PDF-` ????????????? PDF??Blender ??? ????????? PNG | +| **CLI ?????????** | ????? `subprocess.run` ?????????????? | `cli-anything-gimp --json project new` ??? ???? JSON ????? | ``` ================================ Test Summary ================================ -gimp 107 passed ✅ (64 unit + 43 e2e) -blender 208 passed ✅ (150 unit + 58 e2e) -inkscape 202 passed ✅ (148 unit + 54 e2e) -audacity 161 passed ✅ (107 unit + 54 e2e) -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) -lldb 27 passed ✅ (23 unit + 4 e2e) -nsight-graphics 51 passed ✅ (46 unit/CLI + 5 local e2e) -unrealinsights 50 passed ✅ (49 unit + 1 e2e, 9 backend-gated e2e skipped) -sketch 19 passed ✅ (19 jest, Node.js) -3mf 50 passed ✅ (50 unit) -joplin 118 passed ✅ (91 unit + 27 e2e, 1 skipped on Windows) -────────────────────────────────────────────────────────────────────────────── -TOTAL 1,942 passed ✅ 100% pass rate +gimp 107 passed ??? (64 unit + 43 e2e) +blender 208 passed ??? (150 unit + 58 e2e) +inkscape 202 passed ??? (148 unit + 54 e2e) +audacity 161 passed ??? (107 unit + 54 e2e) +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) +lldb 27 passed ??? (23 unit + 4 e2e) +nsight-graphics 51 passed ??? (46 unit/CLI + 5 local e2e) +unrealinsights 50 passed ??? (49 unit + 1 e2e, 9 backend-gated e2e skipped) +sketch 19 passed ??? (19 jest, Node.js) +3mf 50 passed ??? (50 unit) +joplin 123 passed ??? (96 unit + 27 e2e, 1 skipped on Windows) +?????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????? +TOTAL 1,947 passed ??? 100% pass rate ``` --- -## 🏗️ CLI-Anything 的架构 +## ????? CLI-Anything ?????????

CLI-Anything Architecture

-### 🎯 核心设计原则 +### ???? ??????????? -1. **真实软件集成** — CLI 生成合法的项目文件(ODF、MLT XML、SVG),然后交给真实应用去渲染。**我们做的是软件的结构化接口,而不是替代品**。 -2. **灵活的交互模式** — 每个 CLI 都支持两种模式:有状态的 REPL 用于 Agent 交互会话,子命令模式用于脚本和流水线。**直接运行命令即进入 REPL**。 -3. **一致的使用体验** — 所有生成的 CLI 共享统一的 REPL 界面(repl_skin.py),带有品牌横幅、风格化提示符、命令历史、进度指示器和标准化格式。 -4. **Agent 原生设计** — 每个命令内置 `--json` 参数,输出结构化数据供 Agent 消费,同时可读的表格格式服务于交互调试。**Agent 通过标准的 `--help` 和 `which` 命令发现能力**。 -5. **零妥协的依赖策略** — 真实软件是硬性要求 —— 没有兜底,没有降级。**后端缺失时测试直接失败(而非跳过),确保功能的真实性**。 +1. **?????????????** ??? CLI ???????????????????????ODF???MLT XML???SVG????????????????????????????????**?????????????????????????????????????????????**??? +2. **??????????** ??? ?? CLI ??????????????????????????? REPL ????? Agent ???????????????????????????????????**??????????????????? REPL**??? +3. **????????????????** ??? ??????????????? CLI ??????????? REPL ??????repl_skin.py????????????????????????????????????????????????????????????????????? +4. **Agent ????????** ??? ?????????? `--json` ?????????????????????????? Agent ?????????????????????????????????????**Agent ????????????? `--help` ??? `which` ???????????????**??? +5. **????????????????** ??? ????????????????? ?????? ??????????????????????**?????????????????????????????????????????????????????**??? --- -## 📂 项目结构 +## ???? ????????? ``` cli-anything/ -├── 📄 README.md # 英文文档 -├── 📄 README_CN.md # 中文文档(你在这里) -├── 📁 assets/ # 图片和媒体文件 -│ ├── icon.png # 项目图标 -│ └── teaser.png # 概览图 -│ -├── 🔌 cli-anything-plugin/ # Claude Code 插件 -│ ├── HARNESS.md # 方法论 SOP(唯一权威来源) -│ ├── README.md # 插件文档 -│ ├── QUICKSTART.md # 5 分钟快速上手 -│ ├── PUBLISHING.md # 分发与发布指南 -│ ├── repl_skin.py # 统一 REPL 界面 -│ ├── commands/ # 插件命令定义 -│ │ ├── cli-anything.md # 主构建命令 -│ │ ├── refine.md # 扩展已有 harness 覆盖面 -│ │ ├── test.md # 测试运行器 -│ │ ├── validate.md # 标准验证 -│ │ └── list.md # 列出所有 CLI 工具 -│ └── scripts/ -│ └── setup-cli-anything.sh # 安装脚本 -│ -├── 📋 opencode-commands/ # OpenCode 命令 -│ ├── cli-anything.md # 主构建命令 -│ ├── cli-anything-refine.md # 优化扩展命令 -│ ├── cli-anything-test.md # 测试运行器 -│ ├── cli-anything-validate.md # 标准验证 -│ └── cli-anything-list.md # 列出所有 CLI 工具 -│ -├── 🤖 codex-skill/ # Codex skill 接入层 -├── 🎨 gimp/agent-harness/ # GIMP CLI(107 项测试) -├── 🧊 blender/agent-harness/ # Blender CLI(208 项测试) -├── ✏️ inkscape/agent-harness/ # Inkscape CLI(202 项测试) -├── 🎵 audacity/agent-harness/ # Audacity CLI(161 项测试) -├── 📄 libreoffice/agent-harness/ # LibreOffice CLI(158 项测试) -├── 📓 joplin/agent-harness/ # Joplin CLI(118 项测试,新增) -├── 📚 zotero/agent-harness/ # Zotero CLI(新增,支持文献导入) -├── 📹 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 项测试) -├── 🟩 nsight-graphics/agent-harness/ # Nsight Graphics CLI(51 项测试) -├── 🐞 lldb/agent-harness/ # LLDB CLI(27 项测试) -├── 📈 unrealinsights/agent-harness/ # Unreal Insights CLI(50 项测试) -├── 📦 sbox/agent-harness/ # s&box CLI(244 项测试: 157 单元 + 17 orchestrator + 50 e2e + 20 exit-code) -└── 🎨 sketch/agent-harness/ # Sketch CLI(19 项测试,Node.js) +????????? ???? README.md # ?????????? +????????? ???? README_CN.md # ????????????????????? +????????? ???? assets/ # ????????????????? +??? ????????? icon.png # ????????? +??? ????????? teaser.png # ??????? +??? +????????? ???? cli-anything-plugin/ # Claude Code ??? +??? ????????? HARNESS.md # ?????? SOP?????????????? +??? ????????? README.md # ??????? +??? ????????? QUICKSTART.md # 5 ??????????????? +??? ????????? PUBLISHING.md # ???????????????? +??? ????????? repl_skin.py # ???? REPL ???? +??? ????????? commands/ # ??????????? +??? ??? ????????? cli-anything.md # ????????? +??? ??? ????????? refine.md # ????????? harness ?????? +??? ??? ????????? test.md # ?????????? +??? ??? ????????? validate.md # ???????? +??? ??? ????????? list.md # ???????????? CLI ???? +??? ????????? scripts/ +??? ????????? setup-cli-anything.sh # ?????????? +??? +????????? ???? opencode-commands/ # OpenCode ???? +??? ????????? cli-anything.md # ????????? +??? ????????? cli-anything-refine.md # ?????????????? +??? ????????? cli-anything-test.md # ?????????? +??? ????????? cli-anything-validate.md # ???????? +??? ????????? cli-anything-list.md # ???????????? CLI ???? +??? +????????? ???? codex-skill/ # Codex skill ???????? +????????? ???? gimp/agent-harness/ # GIMP CLI??107 ??????? +????????? ???? blender/agent-harness/ # Blender CLI??208 ??????? +????????? ???? inkscape/agent-harness/ # Inkscape CLI??202 ??????? +????????? ???? audacity/agent-harness/ # Audacity CLI??161 ??????? +????????? ???? libreoffice/agent-harness/ # LibreOffice CLI??158 ??????? +????????? ???? joplin/agent-harness/ # Joplin CLI??118 ?????????????? +????????? ???? zotero/agent-harness/ # Zotero CLI??????????????????????????? +????????? ???? 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 ??????? +????????? ???? nsight-graphics/agent-harness/ # Nsight Graphics CLI??51 ??????? +????????? ???? lldb/agent-harness/ # LLDB CLI??27 ??????? +????????? ???? unrealinsights/agent-harness/ # Unreal Insights CLI??50 ??????? +????????? ???? sbox/agent-harness/ # s&box CLI??244 ?????: 157 ????? + 17 orchestrator + 50 e2e + 20 exit-code?? +????????? ???? sketch/agent-harness/ # Sketch CLI??19 ???????Node.js?? ``` -每个 `agent-harness/` 包含一个可安装的 Python 包,位于 `cli_anything.<软件名>/` 下,包含 Click CLI、核心模块、工具类(含 `repl_skin.py` 和后端适配器)以及完整的测试。 +?? `agent-harness/` ??????????????? Python ???????? `cli_anything./` ???????? Click CLI???????????????????? `repl_skin.py` ??????????????????????????????????? --- -## 🎯 插件命令 +## ???? ??????? -| 命令 | 说明 | +| ???? | ???? | |-----|------| -| `/cli-anything <软件路径或仓库>` | 构建完整的 CLI —— 全部 7 个阶段 | -| `/cli-anything:refine <软件路径> [聚焦方向]` | 优化已有的 CLI —— 通过差距分析扩展覆盖面 | -| `/cli-anything:test <软件路径或仓库>` | 运行测试并更新 TEST.md | -| `/cli-anything:validate <软件路径或仓库>` | 按照 HARNESS.md 标准进行验证 | -| `/cli-anything:list` | 列出所有已安装和已生成的 CLI 工具 | +| `/cli-anything ` | ???????????? CLI ?????? ?????? 7 ????? | +| `/cli-anything:refine [??????????]` | ???????????? CLI ?????? ???????????????????????? | +| `/cli-anything:test ` | ?????????????? TEST.md | +| `/cli-anything:validate ` | ?????? HARNESS.md ???????????? | +| `/cli-anything:list` | ?????????????????????????????? CLI ???? | -### 使用示例 +### ??????? ```bash -# 从本地源码为 GIMP 构建完整 CLI +# ??????????? GIMP ????????? CLI /cli-anything /home/user/gimp -# 从 GitHub 仓库构建 +# ?? GitHub ???????? /cli-anything https://github.com/blender/blender -# 优化已有的 CLI —— 全面差距分析 +# ???????????? CLI ?????? ???????????? /cli-anything:refine /home/user/gimp -# 带聚焦方向的优化 -/cli-anything:refine /home/user/shotcut "画中画和视频叠加合成" +# ??????????????????? +/cli-anything:refine /home/user/shotcut "???????????????????????" -# 运行测试并更新 TEST.md +# ?????????????? TEST.md /cli-anything:test /home/user/inkscape -# 按照 HARNESS.md 标准验证 +# ?????? HARNESS.md ???????? /cli-anything:validate /home/user/audacity ``` --- -## 🎮 实际操作演示 +## ???? ????????????? -以 `cli-anything-libreoffice` 为例,看看 Agent 能做什么: +? `cli-anything-libreoffice` ??????????? Agent ??????????? ```bash -# 创建一个 Writer 文档 +# ??????? Writer ???? $ cli-anything-libreoffice document new -o report.json --type writer -✓ Created Writer document: report.json +??? Created Writer document: report.json -# 添加内容 +# ???????? $ cli-anything-libreoffice --project report.json writer add-heading -t "Q1 Report" --level 1 -✓ Added heading: "Q1 Report" +??? Added heading: "Q1 Report" $ cli-anything-libreoffice --project report.json writer add-table --rows 4 --cols 3 -✓ Added 4×3 table +??? Added 4??3 table -# 通过 LibreOffice headless 导出为真实 PDF +# ????? LibreOffice headless ?????????? PDF $ cli-anything-libreoffice --project report.json export render output.pdf -p pdf --overwrite -✓ Exported: output.pdf (42,831 bytes) via libreoffice-headless +??? Exported: output.pdf (42,831 bytes) via libreoffice-headless -# JSON 模式供 Agent 消费 +# JSON ???? Agent ??? $ cli-anything-libreoffice --json document info --project report.json { "name": "Q1 Report", @@ -831,145 +831,145 @@ $ cli-anything-libreoffice --json document info --project report.json } ``` -### REPL 模式 +### REPL ?? ``` $ cli-anything-blender -╔══════════════════════════════════════════╗ -║ cli-anything-blender v1.0.0 ║ -║ Blender CLI for AI Agents ║ -╚══════════════════════════════════════════╝ +???????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????? +??? cli-anything-blender v1.0.0 ??? +??? Blender CLI for AI Agents ??? +???????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????? blender> scene new --name ProductShot -✓ Created scene: ProductShot +??? Created scene: ProductShot blender[ProductShot]> object add-mesh --type cube --location 0 0 1 -✓ Added mesh: Cube at (0, 0, 1) +??? Added mesh: Cube at (0, 0, 1) blender[ProductShot]*> render execute --output render.png --engine CYCLES -✓ Rendered: render.png (1920×1080, 2.3 MB) via blender --background +??? Rendered: render.png (1920??1080, 2.3 MB) via blender --background blender[ProductShot]> exit -Goodbye! 👋 +Goodbye! ???? ``` --- -## 📖 标准手册:HARNESS.md +## ???? ?????????????HARNESS.md -HARNESS.md 是我们通过自动化 CLI 生成,使任意软件具备 Agent 可用性的权威标准操作流程(SOP)。 +HARNESS.md ????????????????????? CLI ???????????????????? Agent ????????????????????????????SOP????? -它记录了在自动化生成过程中经验证并沉淀出的模式与方法论。 +?????????????????????????????????????????????????????????? -这本手册提炼了成功构建全部 13 套生产级 CLI 的关键经验。 +????????????????????????????????? 13 ??????? CLI ??????????????? -### 核心经验 +### ?????? -| 经验 | 说明 | +| ??? | ???? | |-----|------| -| **必须用真实软件** | CLI 必须调用真实应用进行渲染。不能用 Pillow 替代 GIMP,不能自己写渲染器替代 Blender。正确做法:生成合法的项目文件 → 调用真实后端。 | -| **渲染鸿沟** | GUI 应用在渲染时才应用特效。如果你的 CLI 操作了项目文件但用了简陋的导出工具,特效会被静默丢弃。正确做法:原生渲染器 → 滤镜转译 → 渲染脚本。 | -| **滤镜转译** | 在不同格式间映射特效时(如 MLT → ffmpeg),要注意:重复滤镜合并、交错的流排序、参数空间差异、无法映射的特效。 | -| **时间码精度** | 非整数帧率(如 29.97fps)会导致累积舍入误差。用 `round()` 而非 `int()`,显示时用整数运算,测试中允许 ±1 帧容差。 | -| **输出验证** | 永远不要因为进程退出码为 0 就信任导出成功。要验证:魔术字节、ZIP/OOXML 结构、像素分析、音频 RMS 电平、时长检查。 | +| **?????????????** | CLI ???????????????????????????????????? Pillow ???? GIMP???????????????????????? Blender???????????????????????????????? ??? ???????????????? | +| **???????** | GUI ????????????????????????????????????????? CLI ???????????????????????????????????????????????????????????????????????????????? ??? ??????? ??? ????????????? | +| **???????** | ????????????????????????????? MLT ??? ffmpeg????????????????????????????????????????????????????????????????????????????? | +| **?????????** | ???????????????? 29.97fps???????????????????????? `round()` ????? `int()`???????????????????????????????? ±1 ?????? | +| **????????** | ????????????????????? 0 ???????????????????????????????????ZIP/OOXML ?????????????????????????? RMS ????????????????????? | -> 完整方法论见:[`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md) +> ??????????????[`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md) --- -## 📦 安装与使用 +## ???? ?????????? -### Claude Code 用户 +### Claude Code ?????? ```bash -# 添加市场并安装(推荐) +# ?????????????????????? /plugin marketplace add HKUDS/CLI-Anything /plugin install cli-anything -# 为任何有代码库的软件生成 CLI -/cli-anything:cli-anything <软件路径或仓库> +# ?????????????????????? CLI +/cli-anything:cli-anything ``` -### OpenCode 用户 +### OpenCode ?????? ```bash -# 克隆仓库 +# ?????????? git clone https://github.com/HKUDS/CLI-Anything.git -# 请确保使用最新 OpenCode,旧版本可能使用不同的命令目录路径 -# 复制命令和 HARNESS.md 到 OpenCode 命令目录 +# ????????????? OpenCode????????????????????????????????????? +# ??????????? HARNESS.md ??? OpenCode ????????? cp CLI-Anything/opencode-commands/*.md ~/.config/opencode/commands/ cp CLI-Anything/cli-anything-plugin/HARNESS.md ~/.config/opencode/commands/ -# 为任何有代码库的软件生成 CLI -/cli-anything <软件路径或仓库> +# ?????????????????????? CLI +/cli-anything ``` -### 使用生成的 CLI +### ????????????? CLI ```bash -# 安装任意生成的 CLI -cd <软件名>/agent-harness +# ????????????????? CLI +cd /agent-harness pip install -e . -# 验证安装 -which cli-anything-<软件名> +# ??????? +which cli-anything- -# 开始使用 -cli-anything-<软件名> --help -cli-anything-<软件名> # 进入 REPL -cli-anything-<软件名> --json <命令> # JSON 输出供 Agent 使用 +# ???????? +cli-anything- --help +cli-anything- # ????? REPL +cli-anything- --json # JSON ??????? Agent ???? ``` -### 运行测试 +### ??????? ```bash -# 运行某个 CLI 的测试 -cd <软件名>/agent-harness -python3 -m pytest cli_anything/<软件名>/tests/ -v +# ??????? CLI ??????? +cd /agent-harness +python3 -m pytest cli_anything//tests/ -v -# 强制安装模式(推荐用于验证) -CLI_ANYTHING_FORCE_INSTALLED=1 python3 -m pytest cli_anything/<软件名>/tests/ -v -s +# ?????????????????????????? +CLI_ANYTHING_FORCE_INSTALLED=1 python3 -m pytest cli_anything//tests/ -v -s ``` --- -## 🤝 参与贡献 +## ???? ???????? -欢迎贡献!CLI-Anything 天然支持扩展: +????????CLI-Anything ????????????????? -- **新的目标软件** — 用插件为任意有代码库的软件生成 CLI,然后通过 [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md) 提交你的成果。 -- **方法论改进** — 向 `HARNESS.md` 提 PR,把新的经验教训沉淀下来 -- **插件增强** — 新命令、阶段优化、更好的验证逻辑 -- **测试覆盖** — 更多端到端场景、边界情况、工作流测试 +- **?????????????** ??? ????????????????????????????? CLI???????????? [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md) ??????????????? +- **???????????** ??? ?? `HARNESS.md` ? PR????????????????????????? +- **??????** ??? ????????????????????????????????????? +- **?????????** ??? ???????????????????????????????????????? -### 已知局限 +### ????????? -- **依赖强大的基础模型** — CLI-Anything 依赖前沿级别的模型(如 Claude Opus 4.6、Claude Sonnet 4.6、GPT-5.4)才能可靠地生成 harness。较弱或较小的模型可能产出不完整或有误的 CLI,需要大量人工修正。 -- **依赖可用的源代码** — `/cli-anything` 基于源码进行分析和生成。如果目标软件只提供编译后的二进制文件,需要反编译才能获取代码,harness 的质量和覆盖率会显著下降。 -- **可能需要迭代优化** — 单次 `/cli-anything` 运行不一定能完整覆盖所有功能。通常需要执行一次或多次 `/refine` 命令,才能将 CLI 的性能和覆盖率推到生产级水平。 +- **?????????????????** ??? CLI-Anything ?????????????????????? Claude Opus 4.6???Claude Sonnet 4.6???GPT-5.4??????????????????? harness??????????????????????????????????????????? CLI????????????????? +- **?????????????** ??? `/cli-anything` ???????????????????????????????????????????????????????????????????????????????????????????harness ?????????????????????????????????? +- **???????????????** ??? ??? `/cli-anything` ?????????????????????????????????????????????????????????? `/refine` ?????????????? CLI ???????????????????????????????????? --- -## 📖 文档 +## ???? ???? -| 文档 | 说明 | +| ???? | ???? | |-----|------| -| [`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md) | 方法论 SOP — 唯一权威来源 | -| [`cli-anything-plugin/README.md`](cli-anything-plugin/README.md) | 插件文档 — 命令、选项、阶段 | -| [`cli-anything-plugin/QUICKSTART.md`](cli-anything-plugin/QUICKSTART.md) | 5 分钟快速上手 | -| [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md) | 分发与发布指南 | +| [`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md) | ?????? SOP ??? ?????????? | +| [`cli-anything-plugin/README.md`](cli-anything-plugin/README.md) | ??????? ??? ?????????????????? | +| [`cli-anything-plugin/QUICKSTART.md`](cli-anything-plugin/QUICKSTART.md) | 5 ??????????????? | +| [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md) | ???????????????? | -每个生成的 CLI 还包含: +??????????? CLI ???????? -- `<软件名>.md` — 该应用的架构 SOP -- `tests/TEST.md` — 测试计划和结果文档 +- `.md` ??? ??????????????? SOP +- `tests/TEST.md` ??? ???????????????????? --- -## ⭐ Star History +## ? Star History -如果 CLI-Anything 帮到了你,给个 Star 吧!⭐ +????? CLI-Anything ???????????? Star ???