# Crust

> A TypeScript-first, Bun-native CLI framework with composable modules for building type-safe command-line interfaces.

Crust is a TypeScript-first, Bun-native CLI framework designed to sit between minimal arg parsers and heavyweight frameworks. It provides a chainable builder API with full TypeScript inference, zero runtime dependencies, and a composable module ecosystem so you only pull in what you need. Currently in alpha, Crust targets the Bun runtime from the ground up with no Node compatibility layers or legacy baggage.

- **Type-Safe Builder API** — *Immutable, chainable builder pattern with full TypeScript inference; args and flags are inferred from your definitions with no manual type annotations.*
- **Zero Runtime Dependencies** — *Core modules ship with no external dependencies, keeping your CLI lean and fast.*
- **Composable Modules** — *Every capability ships as its own package (`@crustjs/core`, `@crustjs/plugins`, `@crustjs/validate`, `@crustjs/prompts`, etc.); install only what you need.*
- **Plugin System** — *Middleware-based architecture with lifecycle hooks lets you extend CLI behavior cleanly.*
- **Subcommand Routing** — *Nested command trees with automatic resolution and flag inheritance across subcommands via `inherit: true`.*
- **Compile-Time Validation** — *Catches flag alias collisions and variadic arg mistakes before your code runs.*
- **Bun Native** — *Built specifically for the Bun runtime; get started instantly with `bun create crust my-cli`.*
- **Agent Skills Generation** — *`@crustjs/skills` module enables agent skills generation for AI-powered CLI workflows.*
- **Interactive Prompts & Terminal Styling** — *`@crustjs/prompts` and `@crustjs/style` modules provide rich interactive input and terminal output styling.*
- **Type-Safe Config Persistence** — *`@crustjs/store` provides schema-driven config storage for your CLI tools.*

## Features
- TypeScript-first with full type inference
- Zero runtime dependencies
- Chainable builder API
- Composable module ecosystem
- Middleware-based plugin system
- Subcommand routing with flag inheritance
- Compile-time validation
- Bun-native runtime
- Interactive prompts
- Terminal styling
- Schema-first validation adapters
- Type-safe config persistence
- Agent skills generation
- CLI build tooling
- Scaffolding library

## Integrations
Bun, TypeScript, Zod (via @crustjs/validate)

## Platforms
WINDOWS, API, DEVELOPER_SDK, CLI

## Pricing
Open Source

## Version
0.0.22

## Links
- Website: https://crustjs.com
- Documentation: https://crustjs.com/docs
- Repository: https://github.com/chenxin-yan/crust
- EveryDev.ai: https://www.everydev.ai/tools/crustjs