/cli-anything-refine

name: cli-anything-refine
description: Refine an existing CLI-Anything harness to expand coverage and add missing capabilities

cli-anything-refine Command

Refine an existing CLI harness after a successful `/cli-anything` build.

**Target software**: first argument (local path required). **Focus area**: optional second argument / trailing natural-language focus.

CRITICAL: Resolve PLUGIN_ROOT (absolute paths only)

Resolve `PLUGIN_ROOT` in this order (first hit with `references/HARNESS.md` wins):

1. Read `%USERPROFILE%\.cursor\cli-anything-generator.root` or `~/.cursor/cli-anything-generator.root` 2. Else `{default-or-$CURSOR_PLUGINS_HOME}/local/cli-anything/PLUGIN_ROOT.txt` 3. Else that candidate directory if `references/HARNESS.md` exists 4. Else workspace / cloned `cli-anything-plugin/`

Then read `{PLUGIN_ROOT}/references/HARNESS.md` and `{PLUGIN_ROOT}/references/commands/refine.md` with absolute paths.

Cursor Tool Bindings

| Cursor tool | Role | |-------------|------| | Read / Grep / Glob | Inventory current CLI coverage and target APIs | | Shell | Run existing tests; verify new commands | | Write / StrReplace | Add commands, modules, and tests |

Arguments

• Local software path only (same tree used for the original build). Clone first with `/cli-anything` if needed.
• Optional focus area narrows gap analysis (e.g. `"picture-in-picture features"`).

Phase Gates and Resume (hard gate)

Progress: `{software-root}/agent-harness/.cli-anything-progress.json` with `"mode": "refine"`.

• Steps: inventory → capability scan → gap analysis → implement → test → document.
• Do not advance a step until the previous is `completed` in the progress file.
• Resume incomplete refine runs; do not remove existing commands unless the user requests a breaking change.
• Mark `terminal: true` when refine completes or is permanently aborted.

Refine checklist

• Inventory current commands/tests before coding
• Prefer high-impact gaps and thin wrappers around real backend APIs
• Add matching unit/E2E coverage for every new command surface
• Keep HARNESS packaging and `--json` / REPL standards

What This Command Does

Follow `{PLUGIN_ROOT}/references/commands/refine.md` for the full procedure.