CrustJS v0.2 ยท Alpha

Build CLIs
with types.

A TypeScript-first, Bun-native CLI framework with composable modules, full type inference, and zero runtime dependencies.

Quick StartGitHubDiscord
import { Crust } from "@crustjs/core";
import { helpPlugin } from "@crustjs/plugins";

const cli = new Crust("greet")
  .use(helpPlugin())
  .args([{ name: "name", type: "string" }])
  .flags({
    shout: { type: "boolean", alias: "s" },
  })
  .run(({ args, flags }) => {
    const msg = `Hello, ${args.name}!`;
    console.log(
      flags.shout ? msg.toUpperCase() : msg,
    );
  });

await cli.execute();
Why Crust

Everything you need to build CLIs.

Designed from the ground up for TypeScript developers who want type-safe, composable command-line tools without the bloat.

Type-Safe

Full type inference from argument and flag definitions. Zero casts, complete editor support.

Zero Deps

No runtime dependencies. Just TypeScript and Bun. Lightweight and fast to install.

Composable

Modular packages that you can use independently. Pick what you need, leave the rest.

Plugins

Middleware-based hook system. Extend the CLI lifecycle with reusable plugins.

Chainable

Fluent builder API. Configure arguments, flags, and handlers in a clean, readable chain.

Bun Native

Built for Bun runtime. Fast startup, Bun APIs, and native TypeScript execution.

Ecosystem

Modular by design.

Pick the packages you need. Each module is independently versioned and composable.

@crustjs/corev0.0.19-alphaParsing, routing, plugin system
Docs
@crustjs/pluginsv0.1.2-betaOfficial Crust plugins
Docs
@crustjs/crustv0.0.24-alphaCLI build tooling
Docs
@crustjs/createv0.0.7-alphaScaffolding library for create-xx tools
Docs
@crustjs/validatev0.1.2-betaSchema-first validation adapters
Docs
@crustjs/progressv0.0.4-alphaProgress indicators
Docs
@crustjs/promptsv0.1.0-betaInteractive prompts
Docs
@crustjs/stylev0.2.0-betaTerminal styling
Docs
@crustjs/storev0.2.0-betaType-safe config persistence
Docs
@crustjs/skillsv0.1.2-betaAgent skills generation
Docs
@crustjs/manv0.1.2-betaGenerate mdoc(7) manual pages
Docs
@crustjs/testCLI testing helpers
Coming Soon
@crustjs/renderTerminal content rendering
Coming Soon
@crustjs/logStructured logging
Coming Soon
Get Started

One command to scaffold.

Create a new CLI project with full TypeScript support and the complete Crust toolchain configured out of the box.

Terminal
$ bun create crust my-cli
$ cd my-cli
$ bun run dev
src/greet.tsExample CLI
import { Crust } from "@crustjs/core";
import { helpPlugin } from "@crustjs/plugins";

const cli = new Crust("greet")
  .use(helpPlugin())
  .args([{ name: "name", type: "string" }])
  .flags({
    shout: { type: "boolean", alias: "s" },
  })
  .run(({ args, flags }) => {
    const msg = `Hello, ${args.name}!`;
    console.log(
      flags.shout ? msg.toUpperCase() : msg,
    );
  });

await cli.execute();
Read the docs

Start building with Crust.

Join the community, contribute on GitHub, or dive straight into the docs.

Quick StartJoin DiscordGitHub