ProvenPin Install

minimist argv parse: working versions (tested 2026-10-16)

Parse argv arrays with minimist using string, boolean, alias, default and -- options, asserting parsed flags, positional _ and permissive unknown flags, all offline.

passed6 passed · 0 failed2026-10-16 17:50 UTC
Status
passed
Last passed
2026-10-16 17:50 UTC
Tests
6 / 6
Language
TypeScript
Runtime
node v22.23.3
pinned versions4
minimist@1.2.8@types/minimist@1.2.5@types/node@26.6.5tsx@4.23.15
run it
npm install --no-audit --no-fund --ignore-scripts=false
npm test
test environment
node v22.23.3
linux 6.17.0-1022-azure
x64
runner: github-actions 38942732901

The code

Exactly the files that passed. Your agent can pull them with get_recipe("minimist-argv-parse") (install), or see them on GitHub.

package.json
{
  "name": "minimist-argv-parse",
  "private": true,
  "type": "module",
  "scripts": {
    "test": "node --import tsx --test test/*.test.ts"
  },
  "dependencies": {
    "minimist": "1.2.8"
  },
  "devDependencies": {
    "@types/minimist": "1.2.5",
    "@types/node": "26.6.5",
    "tsx": "4.23.15"
  }
}
src/argv.ts
import minimist from "minimist";

export type ParsedCli = {
  name: string;
  verbose: boolean;
  _: (string | number)[];
  "--"?: string[];
  [key: string]: unknown;
};

export function parseCli(argv: string[]): ParsedCli {
  const parsed = minimist(argv, {
    string: ["name"],
    boolean: ["verbose"],
    alias: { v: "verbose", n: "name" },
    default: { name: "world", verbose: false },
    "--": true,
  });
  return parsed as ParsedCli;
}
test/argv.test.ts
import { test } from "node:test";
import assert from "node:assert/strict";
import { parseCli } from "../src/argv.ts";

test("parses string and boolean options", () => {
  const parsed = parseCli(["--name", "alice", "--verbose"]);
  assert.equal(parsed.name, "alice");
  assert.equal(parsed.verbose, true);
});

test("honours aliases", () => {
  const parsed = parseCli(["-n", "bob", "-v"]);
  assert.equal(parsed.name, "bob");
  assert.equal(parsed.verbose, true);
});

test("applies defaults when flags are absent", () => {
  const parsed = parseCli([]);
  assert.equal(parsed.name, "world");
  assert.equal(parsed.verbose, false);
  assert.deepEqual(parsed._, []);
});

test("collects positional arguments into _", () => {
  const parsed = parseCli(["build", "--name", "app", "extra"]);
  assert.deepEqual(parsed._, ["build", "extra"]);
  assert.equal(parsed.name, "app");
});

test("separates arguments after -- when enabled", () => {
  const parsed = parseCli(["--name", "app", "--", "--not-a-flag", "file.txt"]);
  assert.equal(parsed.name, "app");
  assert.deepEqual(parsed["--"], ["--not-a-flag", "file.txt"]);
});

test("keeps unknown flags when not restricted", () => {
  const parsed = parseCli(["--mystery", "x", "--toggle"]);
  assert.equal(parsed.mystery, "x");
  assert.equal(parsed.toggle, true);
});

Connect to ProvenPin

Add the free MCP server so your agent can pull this recipe and others like it. Same setup as the docs.

terminal
claude mcp add --transport http provenpin https://mcp.provenpin.com/mcp

Any other MCP client: Streamable HTTP at https://mcp.provenpin.com/mcp. No API key, no signup.