terrylica/cc-skills

cli-anything

Reference guide for CLI-Anything, which auto-generates production-ready agent-controllable CLI harnesses for any GUI application via a 7-phase.

Voir la source

Mode d’emploi

  1. Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
  2. Consultez le document original pour les outils, identifiants et environnements requis.
  3. Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/terrylica/cc-skills --skill cli-anything

Avant de commencer

  • L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
  • Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

CLI-Anything Reference

Auto-generates production-ready, agent-controllable CLI interfaces for any GUI application with accessible source code. A 7-phase pipeline maps GUI actions to backend APIs and emits Click-based harnesses with --json output mode, interactive REPL, and pytest test suites.

Source: <https://github.com/HKUDS/CLI-Anything> License: MIT | Python: 3.10+ | Tests: 1,508 passing across 11 apps


Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

Installation

Method 1: Claude Code Marketplace (recommended)

/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything

Method 2: Manual Claude Code

bash
git clone https://github.com/HKUDS/CLI-Anything.git
cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything
# Reload in Claude Code:
/reload-plugins

Method 3: OpenCode — global

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/

Method 4: OpenCode — project-level

bash
cp CLI-Anything/opencode-commands/*.md .opencode/commands/
cp CLI-Anything/cli-anything-plugin/HARNESS.md .opencode/commands/

Generating a New CLI Harness

bash
# From local source path
/cli-anything ./gimp

# From GitHub URL (auto-cloned)
/cli-anything https://github.com/blender/blender

# Claude Code variant (plugin command)
/cli-anything ./inkscape

# OpenCode variant
/cli-anything ./libreoffice

All Commands

CommandPlatformPurpose
/cli-anything <path-or-url>Claude CodeBuild full 7-phase harness
/cli-anything:refine <path> [focus]Claude CodeExpand with gap analysis
/cli-anything:test <path-or-url>Claude CodeRun tests + update TEST.md
/cli-anything:validate <path-or-url>Claude CodeVerify HARNESS.md standards
/cli-anything:list [--path dir] [--depth n] [--json]Claude CodeDiscover installed CLI-Anything tools
/cli-anything ./gimpOpenCodeBuild harness
/cli-anything-refine ./gimpOpenCodeRefine harness
/cli-anything-test ./gimpOpenCodeRun tests
/cli-anything-validate ./gimpOpenCodeValidate standards
/cli-anything-listOpenCodeList installed tools

Refinement with Focus

bash
# Broad gap analysis
/cli-anything:refine ./gimp

# Targeted domain expansion
/cli-anything:refine ./gimp "batch processing and filters"
/cli-anything:refine ./blender "rendering pipeline and animations"
/cli-anything:refine ./libreoffice "spreadsheet formulas and macros"

Installing a Generated CLI

bash
cd <software>/agent-harness
pip install -e .

# Verify PATH entry created
which cli-anything-gimp
cli-anything-gimp --help

Using Generated CLIs

All generated CLIs share a consistent interface pattern.

GIMP Example

bash
# Help
cli-anything-gimp --help

# Create project
cli-anything-gimp project new --width 1920 --height 1080 -o poster.json

# Machine-readable JSON output (for agent consumption)
cli-anything-gimp --json layer add -n "Background" --type solid --color "#1a1a2e"

# Interactive REPL
cli-anything-gimp

# Stateful workflow with --project flag
cli-anything-gimp --project poster.json layer add -n "Logo" --type group
cli-anything-gimp --project poster.json export render output.png --format png

LibreOffice Example

bash
# New document
cli-anything-libreoffice document new -o report.json --type writer

# Populate document
cli-anything-libreoffice --project report.json writer add-heading -t "Q1 Report" --level 1
cli-anything-libreoffice --project report.json writer add-table --rows 4 --cols 3

# Export
cli-anything-libreoffice --project report.json export render output.pdf -p pdf --overwrite

# JSON output
cli-anything-libreoffice --json document info --project report.json

Blender Example

bash
cli-anything-blender scene new -o scene.json
cli-anything-blender --project scene.json object add --type mesh --mesh-type CUBE
cli-anything-blender --project scene.json render image output.png --engine CYCLES
cli-anything-blender --json scene info --project scene.json

Inkscape Example

bash
cli-anything-inkscape document new --width 800 --height 600 -o design.json
cli-anything-inkscape --project design.json shape add rect --x 10 --y 10 --w 200 --h 100
cli-anything-inkscape --project design.json export render output.svg
cli-anything-inkscape --json document info --project design.json

Output Modes

Every command supports two output modes:

ModeUsageAudience
Human-readable (default)cli-anything-gimp layer add ...Terminal / humans
Machine-readable JSONcli-anything-gimp --json layer add ...AI agents, scripts

The --json flag is always the first argument, before any subcommands.


Interactive REPL

Enter by running the CLI with no subcommands:

bash
cli-anything-gimp
cli-anything-blender
cli-anything-libreoffice

REPL features:

  • 50-level undo/redo stack
  • Persistent command history
  • ANSI 256-color output (software-specific accent colors)
  • Table rendering, progress indicators
  • All subcommands available interactively

Running Tests

bash
# Standard pytest run
cd <software>/agent-harness
python3 -m pytest cli_anything/<software>/tests/ -v

# Validate the installed binary is invoked (not just the module)
CLI_ANYTHING_FORCE_INSTALLED=1 python3 -m pytest cli_anything/<software>/tests/ -v -s

# Coverage
python3 -m pytest cli_anything/<software>/tests/ --cov=cli_anything/<software>

# Per-software examples
cd gimp/agent-harness && python3 -m pytest cli_anything/gimp/tests/ -v
cd blender/agent-harness && python3 -m pytest cli_anything/blender/tests/ -v
cd libreoffice/agent-harness && python3 -m pytest cli_anything/libreoffice/tests/ -v

Environment Variables

VariablePurpose
CLI_ANYTHING_FORCE_INSTALLED=1Forces tests to use the real installed binary (validates which cli-anything-<software> resolves correctly, not just module import)

Supported Applications (11 total, 1,508 tests)

ApplicationCategoryEntry Point
GIMPCreative (raster)cli-anything-gimp
BlenderCreative (3D)cli-anything-blender
InkscapeCreative (vector)cli-anything-inkscape
AudacityMedia (audio)cli-anything-audacity
LibreOfficeProductivitycli-anything-libreoffice
OBS StudioMedia (streaming)cli-anything-obs-studio
KdenliveMedia (video)cli-anything-kdenlive
ShotcutMedia (video)cli-anything-shotcut
ZoomCommunicationcli-anything-zoom
Draw.ioDiagrammingcli-anything-drawio
AnyGenAI Contentcli-anything-anygen

The 7-Phase Pipeline (HARNESS.md)

What /cli-anything triggers under the hood:

PhaseNameWhat happens
1Source AcquisitionAccept local path or GitHub URL; clone if needed
2Codebase AnalysisMap GUI actions → backend APIs; inventory existing CLI tools; document data model
3CLI Architecture DesignChoose interaction model (stateful REPL + subcommand); define command groups; plan --json output
4ImplementationBuild Click-based CLI with cli_anything.<software> namespace; implement REPL via shared ReplSkin
5Test PlanningWrite TEST.md with planned test inventory before code
6Test ImplementationUnit tests (synthetic data) + E2E tests (real software output) + subprocess tests
7PyPI Publishingsetup.py with find_namespace_packages(); console_scripts entry points

Fundamental Rule: The CLI MUST delegate rendering to the real software — never reimplement functionality in Python. The target software is a hard dependency.


Generated Harness Structure

Each generated CLI follows this layout (PEP 420 namespace packages):

<software>/agent-harness/
├── setup.py                          # find_namespace_packages(), entry_points
├── <SOFTWARE>.md                     # Software-specific SOP
└── cli_anything/                     # NO __init__.py (namespace package)
    └── <software>/
        ├── __init__.py
        ├── __main__.py
        ├── <software>_cli.py         # Main Click entry point
        ├── core/                     # Domain modules (project, session, export, ...)
        ├── utils/
        │   └── repl_skin.py          # Shared REPL UI (copied from plugin)
        └── tests/
            ├── TEST.md               # Test inventory (written in phase 5)
            ├── test_core.py          # Unit tests
            └── test_full_e2e.py      # E2E + subprocess tests

Why namespace packages: cli_anything/ has no __init__.py, enabling multiple separately-installed CLIs to coexist under the same cli_anything.* namespace without conflict.


Output Verification Standards

Tests verify real output using magic bytes and content analysis:

Output TypeVerification
PDF%PDF- magic bytes + non-zero size
OOXML (.docx, .xlsx)ZIP structure validation
CSVData row count + column check
ImagesPillow pixel value analysis
AudioRMS level check (non-silent)

Prerequisites Checklist

Before running /cli-anything <path>:

  • [ ] Python 3.10+ installed
  • [ ] Target software installed (hard dependency — it will be called for rendering)
  • [ ] Source code accessible (local path or public GitHub URL)
  • [ ] click>=8.0.0 available (installed via pip install -e .)
  • [ ] Pillow>=10.0.0, prompt-toolkit>=3.0.0 available
  • [ ] pytest available for running tests

Key Files Reference

FilePurpose
cli-anything-plugin/HARNESS.mdComplete methodology document (30K chars)
cli-anything-plugin/QUICKSTART.mdQuick start guide
cli-anything-plugin/repl_skin.pyShared REPL UI class (18K, ANSI 256-color)
cli-anything-plugin/commands/cli-anything.md/cli-anything slash command definition
cli-anything-plugin/commands/refine.md/cli-anything:refine command
cli-anything-plugin/commands/test.md/cli-anything:test command
cli-anything-plugin/commands/validate.md/cli-anything:validate command
cli-anything-plugin/commands/list.md/cli-anything:list command

Post-Execution Reflection

After this skill completes, check before closing:

  1. Did the command succeed? — If not, fix the instruction or error table that caused the failure.
  2. Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
  3. Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.

du même dépôt

Autres Skills

Tous les Skills
terrylica
Communauté

academic-pdf-to-gfm

Convert academic PDF papers to GitHub-renderable GFM markdown with math equations. TRIGGERS - PDF, GitHub markdown, math

Installations / 1h
1
GitHub Stars
2
Mis à jour
5 nov.
terrylica
Communauté

adr-code-traceability

Add ADR references to code for traceability. TRIGGERS - ADR traceability, code reference, document decision in code.

Installations / 1h
1
GitHub Stars
2
Mis à jour
5 nov.
terrylica
Communauté

arxiv-source-first-paper-ingest

Read an arXiv paper faithfully by fetching the authors' own LaTeX source instead of OCR-ing the PDF. Extracts every display equation with its label, environment and enclosing proposition, renders each to MathML, and proves usability by compiling each formula with a real TeX engine. Use when you need a paper's formulas exactly — to replicate a method, implement a loss function or custom objective, verify a quoted number, or check a claim against what the authors actually wrote. TRIGGERS - read th

Installations / 1h
1
GitHub Stars
2
Mis à jour
5 nov.
terrylica
Communauté

azure-provision

Bootstrap Azure automation when interactive az login is blocked by a Conditional Access policy (error 530035, "Device state: Unregistered"). Mints a service principal through the Azure Portal session ONCE — using Microsoft Graph over a captured token, not DOM clicking — then provisions resource groups, Cognitive Services / AI Language / Speech resources and their keys entirely via az/REST, writing key AND endpoint together into the SCS vault. Use when az login fails but the portal works, when mo

Installations / 1h
1
GitHub Stars
2
Mis à jour
5 nov.