clipseCLI parsing so easy

A tiny, type-safe CLI builder for Bun & Node. Declare options and arguments, get a fully typed action callback.

Type-safe by design

Options and arguments you declare are inferred into the action callback — wrong keys and wrong value types fail to compile.

Fluent builder

Chain addOptions, addArguments, addSubcommands and action, then call ready(). That's the whole API.

Batteries included

Subcommands, default commands, global options, auto-generated help, and a bash completion generator.

Zero runtime dependencies

Ships as ESM + CJS with type declarations. TypeScript is the only peer dependency.

Quick look

import { Clipse } from "clipse";

new Clipse("greet", "say hello", "1.0.0")
  .addOptions({
    loud: { short: "l", type: "boolean", description: "shout it" },
  })
  .addArguments([{ name: "who", description: "who to greet" }])
  .action((args, opts) => {
    const msg = `Hello, ${args.who ?? "world"}!`;
    console.log(opts.loud ? msg.toUpperCase() : msg);
  })
  .ready();

$ greet Alice --loud
HELLO, ALICE!

Documentation, the Diátaxis way

This documentation follows the Diátaxis framework:

Tutorials — learning-oriented lessons that take you by the hand.
How-to guides — recipes for solving specific problems.
Reference — the precise, exhaustive description of the API.
Explanation — the background and design decisions.