From bb512aba4433d3f14fb7ab7de723300a44d47624 Mon Sep 17 00:00:00 2001 From: yuhao Date: Mon, 23 Mar 2026 17:17:40 +0000 Subject: [PATCH] fix cli-hub-skill --- .github/workflows/deploy-pages.yml | 15 +-- README.md | 4 +- cli-hub-meta-skill/SKILL.md | 8 +- docs/hub/SKILL.txt | 141 +++++++++++++++++++++++++++++ docs/hub/index.html | 4 +- 5 files changed, 153 insertions(+), 19 deletions(-) create mode 100644 docs/hub/SKILL.txt diff --git a/.github/workflows/deploy-pages.yml b/.github/workflows/deploy-pages.yml index 59745d0a5..b0e4c1984 100644 --- a/.github/workflows/deploy-pages.yml +++ b/.github/workflows/deploy-pages.yml @@ -41,10 +41,8 @@ jobs: - name: Generate meta-skill run: python3 .github/scripts/generate_meta_skill.py - - name: Copy catalog as static asset (bypass Jekyll) - run: | - mkdir -p docs/hub/static - cp cli-hub-skill/SKILL.md docs/hub/static/catalog.md + - name: Copy catalog as .txt to avoid Jekyll processing + run: cp cli-hub-skill/SKILL.md docs/hub/SKILL.txt - name: Build with Jekyll uses: actions/jekyll-build-pages@v1 @@ -52,17 +50,10 @@ jobs: source: ./docs/hub destination: ./docs/_site - - name: Rename catalog.md to SKILL.md in built site - run: | - mkdir -p ./docs/_site_final - cp -r ./docs/_site/* ./docs/_site_final/ 2>/dev/null || true - mv ./docs/_site_final/static/catalog.md ./docs/_site_final/SKILL.md - rm -rf ./docs/_site_final/static - - name: Upload artifact uses: actions/upload-pages-artifact@v3 with: - path: './docs/_site_final' + path: './docs/_site' deploy: environment: diff --git a/README.md b/README.md index d69e1272f..5d4b4f6d6 100644 --- a/README.md +++ b/README.md @@ -400,13 +400,13 @@ Each installed CLI ships with a [`SKILL.md`](#-skillmd-generation) inside the Py CLI-Hub lets agents autonomously discover and install the CLIs they need — zero human intervention required. -**Agent-Native Catalog:** [`https://hkuds.github.io/CLI-Anything/SKILL.md`](https://hkuds.github.io/CLI-Anything/SKILL.md) +**Agent-Native Catalog:** [`https://hkuds.github.io/CLI-Anything/SKILL.txt`](https://hkuds.github.io/CLI-Anything/SKILL.txt) CLI-Anything ships a **meta-skill** that lets any AI agent browse, pick, and install from the full catalog of community CLIs. **How it works:** -1. Point your agent to the catalog: [`https://hkuds.github.io/CLI-Anything/SKILL.md`](https://hkuds.github.io/CLI-Anything/SKILL.md) +1. Point your agent to the catalog: [`https://hkuds.github.io/CLI-Anything/SKILL.txt`](https://hkuds.github.io/CLI-Anything/SKILL.txt) 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 diff --git a/cli-hub-meta-skill/SKILL.md b/cli-hub-meta-skill/SKILL.md index 564417bf5..802ac6c12 100644 --- a/cli-hub-meta-skill/SKILL.md +++ b/cli-hub-meta-skill/SKILL.md @@ -11,13 +11,15 @@ CLI-Hub is a marketplace of agent-native command-line interfaces that make profe ## Live Catalog -**URL**: [`https://hkuds.github.io/CLI-Anything/SKILL.md`](https://hkuds.github.io/CLI-Anything/SKILL.md) +**URL**: [`https://hkuds.github.io/CLI-Anything/SKILL.txt`](https://hkuds.github.io/CLI-Anything/SKILL.txt) The catalog is auto-updated and provides: - Full list of available CLIs organized by category - One-line `pip install` commands for each tool - Complete descriptions and usage patterns +**Note**: The file is served as `.txt` but contains markdown formatting for easy parsing. + ## What Can You Do? CLI-Hub covers a broad range of software and codebases, empowering agents to conduct complex workflows via CLI: @@ -33,7 +35,7 @@ Each CLI provides stateful operations, JSON output for agents, REPL mode, and in ## How to Use -1. **Read the catalog**: Fetch `https://hkuds.github.io/CLI-Anything/SKILL.md` +1. **Read the catalog**: Fetch `https://hkuds.github.io/CLI-Anything/SKILL.txt` (markdown format) 2. **Find your tool**: Browse by category to discover the CLI you need 3. **Install**: Use the provided `pip install` command 4. **Execute**: All CLIs support `--json` flag for machine-readable output @@ -51,6 +53,6 @@ cli-anything- --json [options] ## More Info -- Live Catalog: https://hkuds.github.io/CLI-Anything/SKILL.md +- Live Catalog: https://hkuds.github.io/CLI-Anything/SKILL.txt - Web Hub: https://hkuds.github.io/CLI-Anything/ - Repository: https://github.com/HKUDS/CLI-Anything diff --git a/docs/hub/SKILL.txt b/docs/hub/SKILL.txt new file mode 100644 index 000000000..95e8caa70 --- /dev/null +++ b/docs/hub/SKILL.txt @@ -0,0 +1,141 @@ +--- +name: cli-anything-hub +description: >- + Browse and install 21+ agent-native CLI tools for GUI software. + Covers image editing, 3D, video, audio, office, diagrams, AI, and more. +--- + +# CLI-Anything Hub + +Agent-native stateful CLI interfaces for 21 applications. All CLIs support `--json` output, REPL mode, and undo/redo. + +## Quick Install + +```bash +# Install any CLI +pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=/agent-harness + +# Example: Install GIMP CLI +pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=gimp/agent-harness +``` + +## Available CLIs + +### 3D + +| Name | Description | Install | +|------|-------------|---------| +| **Blender** | 3D modeling, animation, and rendering via blender --background --python | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=blender/agent-harness` | + +### Ai + +| Name | Description | Install | +|------|-------------|---------| +| **ComfyUI** | AI image generation workflow management via ComfyUI REST API | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=comfyui/agent-harness` | +| **NotebookLM** | Experimental NotebookLM harness scaffold wrapping the installed notebooklm CLI for notebook, source, chat, artifact, download, and sharing workflows | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=notebooklm/agent-harness` | +| **Novita** | Access AI models via Novita's OpenAI-compatible API (DeepSeek, GLM, MiniMax) | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=novita/agent-harness` | +| **Ollama** | Local LLM inference and model management via Ollama REST API | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=ollama/agent-harness` | + +### Audio + +| Name | Description | Install | +|------|-------------|---------| +| **Audacity** | Audio editing and processing via sox | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=audacity/agent-harness` | + +### Communication + +| Name | Description | Install | +|------|-------------|---------| +| **Zoom** | Meeting management via Zoom REST API (OAuth2) | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=zoom/agent-harness` | + +### Design + +| Name | Description | Install | +|------|-------------|---------| +| **Sketch** | Generate Sketch design files (.sketch) from JSON design specifications via sketch-constructor | `cd sketch/agent-harness && npm install && npm link` | + +### Diagrams + +| Name | Description | Install | +|------|-------------|---------| +| **Draw.io** | Diagram creation and export via draw.io CLI | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=drawio/agent-harness` | +| **Mermaid** | Mermaid Live Editor state files and renderer URLs | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=mermaid/agent-harness` | + +### Generation + +| Name | Description | Install | +|------|-------------|---------| +| **AnyGen** | Generate docs, slides, websites and more via AnyGen cloud API | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=anygen/agent-harness` | + +### Image + +| Name | Description | Install | +|------|-------------|---------| +| **GIMP** | Raster image processing via gimp -i -b (batch mode) | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=gimp/agent-harness` | +| **Inkscape** | SVG vector graphics with export via inkscape --export-filename | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=inkscape/agent-harness` | + +### Music + +| Name | Description | Install | +|------|-------------|---------| +| **MuseScore** | CLI for music notation — transpose, export PDF/audio/MIDI, extract parts, manage instruments | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=musescore/agent-harness` | + +### Network + +| Name | Description | Install | +|------|-------------|---------| +| **AdGuardHome** | DNS ad-blocking and network infrastructure management via AdGuardHome REST API | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=adguardhome/agent-harness` | + +### Office + +| Name | Description | Install | +|------|-------------|---------| +| **LibreOffice** | Create and manipulate ODF documents, export to PDF/DOCX/XLSX/PPTX via headless mode | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=libreoffice/agent-harness` | +| **Mubu** | Knowledge management and outlining via local Mubu desktop data | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=mubu/agent-harness` | + +### Streaming + +| Name | Description | Install | +|------|-------------|---------| +| **OBS Studio** | Create and manage streaming/recording scenes via command line | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=obs-studio/agent-harness` | + +### Video + +| Name | Description | Install | +|------|-------------|---------| +| **Kdenlive** | Video editing and rendering via melt | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=kdenlive/agent-harness` | +| **Shotcut** | Video editing and rendering via melt/ffmpeg | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=shotcut/agent-harness` | + +### Web + +| Name | Description | Install | +|------|-------------|---------| +| **Browser** | Browser automation via DOMShell MCP server. Maps Chrome's Accessibility Tree to a virtual filesystem for agent-native navigation. | `pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=browser/agent-harness` | + +## Usage Pattern + +All CLIs follow the same pattern: + +```bash +# Interactive REPL +cli-anything- + +# One-shot command +cli-anything- [options] + +# JSON output for agents +cli-anything- --json +``` + +## For AI Agents + +1. Install the CLI you need from the table above +2. Read its full SKILL.md at the repo path shown in registry.json +3. Always use `--json` flag for machine-readable output +4. Check exit codes (0=success, non-zero=error) + +## More Info + +- Repository: https://github.com/HKUDS/CLI-Anything +- Web Hub: https://hkuds.github.io/CLI-Anything/ +- Last Updated: 2026-03-18 diff --git a/docs/hub/index.html b/docs/hub/index.html index 7c421047b..40ce8a61d 100644 --- a/docs/hub/index.html +++ b/docs/hub/index.html @@ -380,8 +380,8 @@

CLI-Anything Hub

Any software. Any codebase. Any Web API. Generate an agent-native CLI and let AI agents operate it — install with a single pip command.

- - 🤖 Agent Catalog (SKILL.md) + + 🤖 Agent Catalog (SKILL.txt)

Feed this to your AI agent for autonomous CLI discovery & installation