https://github.com/chenxin-yan/crust

A TypeScript-first, Bun-native CLI framework with composable modules.
https://github.com/chenxin-yan/crust

bun bunjs cli framework javascript typescript

Last synced: 7 days ago
JSON representation

A TypeScript-first, Bun-native CLI framework with composable modules.

• Host: GitHub
• URL: https://github.com/chenxin-yan/crust
• Owner: chenxin-yan
• License: mit
• Created: 2026-02-12T01:39:39.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2026-03-29T21:55:17.000Z (20 days ago)
• Last Synced: 2026-03-29T22:24:50.330Z (20 days ago)
• Topics: bun, bunjs, cli, framework, javascript, typescript
• Language: TypeScript
• Homepage: https://crustjs.com/
• Size: 2.9 MB
• Stars: 341
• Watchers: 1
• Forks: 5
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          


  

  


  Crust



A TypeScript-first, Bun-native CLI framework with composable modules.




  

  





  Website & Docs

    •  

  Contributing

    •  

  Issues

    •  

  Discord



## What is Crust?

Crust is a modern CLI framework built specifically for TypeScript and Bun. It provides a modular architecture for building command-line tools with features like command routing, argument parsing, interactive prompts, validation, and persistence—all with first-class TypeScript support.

## Who uses Crust?

- [Nia CLI](https://github.com/nozomio-labs/nia-cli) by [Nozomio Labs](https://www.trynia.ai/)

## Packages

| Package                                                                | Description                                                                      | Version                                                                                                   | Downloads                                                                                                        |

| ---------------------------------------------------------------------- | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |

| [`@crustjs/crust`](https://www.npmjs.com/package/@crustjs/crust)       | CLI tooling — build and distribute standalone executables                        | [![npm](https://img.shields.io/npm/v/@crustjs/crust)](https://www.npmjs.com/package/@crustjs/crust)       | [![downloads](https://img.shields.io/npm/dm/@crustjs/crust)](https://www.npmjs.com/package/@crustjs/crust)       |

| [`@crustjs/core`](https://www.npmjs.com/package/@crustjs/core)         | Core: command definition, arg parsing, routing, plugins, errors                  | [![npm](https://img.shields.io/npm/v/@crustjs/core)](https://www.npmjs.com/package/@crustjs/core)         | [![downloads](https://img.shields.io/npm/dm/@crustjs/core)](https://www.npmjs.com/package/@crustjs/core)         |

| [`@crustjs/plugins`](https://www.npmjs.com/package/@crustjs/plugins)   | Official plugins: help, version, autocomplete                                    | [![npm](https://img.shields.io/npm/v/@crustjs/plugins)](https://www.npmjs.com/package/@crustjs/plugins)   | [![downloads](https://img.shields.io/npm/dm/@crustjs/plugins)](https://www.npmjs.com/package/@crustjs/plugins)   |

| [`@crustjs/style`](https://www.npmjs.com/package/@crustjs/style)       | Terminal styling foundation                                                      | [![npm](https://img.shields.io/npm/v/@crustjs/style)](https://www.npmjs.com/package/@crustjs/style)       | [![downloads](https://img.shields.io/npm/dm/@crustjs/style)](https://www.npmjs.com/package/@crustjs/style)       |

| [`@crustjs/progress`](https://www.npmjs.com/package/@crustjs/progress) | Progress indicators for async CLI tasks                                          | [![npm](https://img.shields.io/npm/v/@crustjs/progress)](https://www.npmjs.com/package/@crustjs/progress) | [![downloads](https://img.shields.io/npm/dm/@crustjs/progress)](https://www.npmjs.com/package/@crustjs/progress) |

| [`@crustjs/prompts`](https://www.npmjs.com/package/@crustjs/prompts)   | Interactive terminal prompts                                                     | [![npm](https://img.shields.io/npm/v/@crustjs/prompts)](https://www.npmjs.com/package/@crustjs/prompts)   | [![downloads](https://img.shields.io/npm/dm/@crustjs/prompts)](https://www.npmjs.com/package/@crustjs/prompts)   |

| [`@crustjs/validate`](https://www.npmjs.com/package/@crustjs/validate) | Validation helpers                                                               | [![npm](https://img.shields.io/npm/v/@crustjs/validate)](https://www.npmjs.com/package/@crustjs/validate) | [![downloads](https://img.shields.io/npm/dm/@crustjs/validate)](https://www.npmjs.com/package/@crustjs/validate) |

| [`@crustjs/store`](https://www.npmjs.com/package/@crustjs/store)       | DX-first, typed persistence for CLI apps with config/data/state/cache separation | [![npm](https://img.shields.io/npm/v/@crustjs/store)](https://www.npmjs.com/package/@crustjs/store)       | [![downloads](https://img.shields.io/npm/dm/@crustjs/store)](https://www.npmjs.com/package/@crustjs/store)       |

| [`@crustjs/skills`](https://www.npmjs.com/package/@crustjs/skills)     | Agent skill generation from Crust command definitions                            | [![npm](https://img.shields.io/npm/v/@crustjs/skills)](https://www.npmjs.com/package/@crustjs/skills)     | [![downloads](https://img.shields.io/npm/dm/@crustjs/skills)](https://www.npmjs.com/package/@crustjs/skills)     |

| [`@crustjs/create`](https://www.npmjs.com/package/@crustjs/create)     | Headless scaffolding engine for building create-xxx tools                        | [![npm](https://img.shields.io/npm/v/@crustjs/create)](https://www.npmjs.com/package/@crustjs/create)     | [![downloads](https://img.shields.io/npm/dm/@crustjs/create)](https://www.npmjs.com/package/@crustjs/create)     |

| [`create-crust`](https://www.npmjs.com/package/create-crust)           | Project scaffolding tool                                                         | [![npm](https://img.shields.io/npm/v/create-crust)](https://www.npmjs.com/package/create-crust)           | [![downloads](https://img.shields.io/npm/dm/create-crust)](https://www.npmjs.com/package/create-crust)           |

## Getting Started

```sh

bun create crust my-cli

cd my-cli

bun run dev

```