{"by":"jellyotsiro","descendants":12,"id":47408727,"kids":[47416483,47415769,47416337,47416193,47416015,47415751],"score":23,"text":"We've been building Crust (https://crustjs.com/), a TypeScript-first, Bun-native CLI framework with zero dependencies. It's been powering our core product internally for a while, and we're now open-sourcing it.

The problem we kept running into: existing CLI frameworks in the JS ecosystem are either minimal arg parsers where you wire everything yourself, or heavyweight frameworks with large dependency trees and Node-era assumptions. We wanted something in between.

What Crust does differently:

- Full type inference from definitions — args and flags are inferred automatically. No manual type annotations, no generics to wrangle. You define a flag as type: "string" and it flows through to your handler.

- Compile-time validation — catches flag alias collisions and variadic arg mistakes before your code runs, not at runtime.

- Zero runtime dependencies — @crustjs/core is ~3.6kB gzipped (21kB install). For comparison: yargs is 509kB, oclif is 411kB.

- Composable modules — core, plugins, prompts, styling, validation, and build tooling are all separate packages. Install only what you need.

- Plugin system — middleware-based with lifecycle hooks (preRun/postRun). Official plugins for help, version, and shell autocompletion.

- Built for Bun — no Node compatibility layers, no legacy baggage.

Quick example:

  import { Crust } from "@crustjs/core";\n  import { helpPlugin, versionPlugin } from "@crustjs/plugins";\n\n  const main = new Crust("greet")\n    .args([{ name: "name", type: "string", default: "world" }])\n    .flags({ shout: { type: "boolean", short: "s" } })\n    .use(helpPlugin())\n    .use(versionPlugin("1.0.0"))\n    .run(({ args, flags }) => {\n      const msg = `Hello, ${args.name}!`;\n      console.log(flags.shout ? msg.toUpperCase() : msg);\n    });\n\n  await main.execute();\n

\nScaffold a new project:

  bun create crust my-cli\n

\nSite: https://crustjs.com\nGitHub: https://github.com/chenxin-yan/crustjs

Happy to answer any questions about the design decisions or internals.","time":1773722609,"title":"Show HN: Crust – A CLI framework for TypeScript and Bun","type":"story","url":"https://github.com/chenxin-yan/crust"}