cli-to-js-api-wrapper — Claude Code skill: CLI into a JS API

What cli-to-js-api-wrapper does

The skill covers the cli-to-js package. It runs a binary's --help, turns that output into a schema, and hands back a Proxy where each subcommand is a method and each flag is an option. Positional arguments go under the _ key, and camelCase keys are rewritten to kebab-case flags, so { dryRun: true } becomes --dry-run.

TypeScript generics get their own section: you declare the subcommands and their options once and keep autocomplete plus type errors on later calls. Validation is the part worth reading twice. $validate reports flags the binary does not have and suggests near matches, which matters in agent loops where a made-up flag would otherwise reach the shell. Output helpers include .text(), .lines() and .json<T>(), and there is streaming through callbacks or $spawn, plus $command for building the command string without running it.

You need Node.js and the package itself: npm install cli-to-js. The wrapper only reaches binaries already present on the machine — convertCliToJs("git") installs nothing. Tools whose --help is a wall of unstructured text are a poor fit; for those you feed the help string to fromHelpText yourself.