cli-anything

Generate Click-based Python CLI harnesses for GUI applications and repositories.

Updated May 7, 2026
One-click install
npx skills add https://github.com/dawsonblock/JUDGE_ATLAS --skill cli-anything-dawsonblock
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cli-anything
Source: https://github.com/dawsonblock/JUDGE_ATLAS/tree/main/external/CLI-Anything-main/codex-skill
Command: npx skills add https://github.com/dawsonblock/JUDGE_ATLAS --skill cli-anything-dawsonblock

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It eliminates the manual effort of writing and maintaining a testable CLI harness for a GUI-driven application or a source repository, so you can run build/refine/test/validate workflows consistently.

Core Features & Use Cases

  • Harness generation for target software: Creates a Click-based, stateful Python harness that adapts the CLI-Anything methodology to a standardized harness format for Codex.
  • Operational modes for existing or new targets: Supports Build (create new harness), Refine (inventory and gap analysis without removing commands unless breaking change is requested), Test (unit and end-to-end workflow planning), and Validate (checks installability, JSON output, and REPL default behavior).
  • Backend-faithful implementation: Prefer wrapping the real executable/CLI/backend instead of reimplementing functionality, reducing drift and increasing reliability.

Quick Start

Ask Codex: "Use cli-anything to build a new CLI harness for https://github.com/<owner>/<repo>, then produce the installable harness structure and an initial test plan."

Frequently Asked Questions about cli-anything

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a Python CLI harness for a GUI application?

Generate a Python CLI harness by creating a Click-based, stateful interface that wraps the target GUI application to enable deterministic build, test, and validation workflows.

What is the best way to automate testing for a GUI-driven application using a REPL interface?

Automate testing for GUI-driven applications by mapping interactions into a Click CLI with REPL-first interface and JSON output, applying a two-layer test strategy including subprocess-based e2e validation.

How does namespace packaging work when building a Click CLI harness?

Namespace packaging structures the generated Python harness directory layout to expose console_scripts entry points, ensuring reliable command inventory and gap analysis during refinement.

Can I use an existing source repository to build a stateful CLI with undo and redo support?

Yes, you can build a stateful CLI from an existing source repository by wrapping the real backend executable to map API interactions into commands with undo and redo when supported.

Does the generated CLI harness support JSON output for automated validation workflows?

The generated CLI harness supports JSON output and REPL default behavior, validating installability and deterministic command execution without reimplementing backend functionality.

What are the limitations of wrapping a real executable instead of reimplementing CLI functionality?

Wrapping a real executable reduces drift and increases reliability, but limitations include dependency on the backend's existing capabilities and potential constraints when the target lacks undo or redo support.