Cli To Js Api Wrapper

Turns any CLI tool into a typed JavaScript API by parsing its help output and exposing subcommands as methods. You call git.commit({ message: "fix", all: true }) instead of spawning shell strings, which matters for agent workflows where you want validation before execution. The $validate method catches hallucinated flags and suggests corrections, and it generates standalone TypeScript wrappers with zero runtime deps. Streaming via async iterators, execution callbacks, and script composition are all built in. The Proxy-based approach means you get autocomplete for any binary on your system without handwriting wrappers. Clever use of help text parsing to bridge imperative shell tools and structured code.

skills.sh installs: 336
GitHub stars: 26
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add aradotso/trending-skills --skill cli-to-js-api-wrapper --agent claude-code

Installs into .claude/skills of the current project.

Files

cli-to-js: Turn Any CLI Into a JavaScript API

Skill by ara.so — Daily 2026 Skills collection.

cli-to-js reads a binary's --help output, parses it into a schema, and returns a fully typed Proxy-based API where subcommands are methods and flags are options. Designed for agent workflows where structured APIs are safer than raw shell strings.

Install

npm install cli-to-js

Core Concepts

convertCliToJs(binary) — runs --help, parses output, returns typed API proxy
fromHelpText(binary, text) — same but from a static help string
Every subcommand becomes a method: api.subcommand({ flag: value })
Positional args use the _ key: api.command({ _: ["file.txt"] })
camelCase keys auto-convert to kebab-case flags: { dryRun: true } → --dry-run