bunli

Build type-safe Bun CLIs with Zod-validated commands and plugins.

95|5|Updated Jun 16, 2025
One-click install
npx skills add https://github.com/AryaLabsHQ/bunli --skill bunli-aryalabshq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bunli
Source: https://github.com/AryaLabsHQ/bunli/tree/main/skills/bunli
Command: npx skills add https://github.com/AryaLabsHQ/bunli --skill bunli-aryalabshq

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Bunli eliminates the friction of building reliable command-line tools by providing a minimal, type-safe framework for Bun, so you can define commands, validate inputs, and ship interactive CLIs faster.

Core Features & Use Cases

  • Type-safe command definitions with validation: Define commands and options with Zod-driven, properly coerced types so handlers receive correct flag values.
  • Plugin architecture for extensibility: Add features like environment/AI detection, shell completions, config loading/merging, and MCP integration without rewriting your CLI core.
  • Interactive CLI with prompts and spinners + Bunli TUI components: Build guided flows (prompts, spinners) and reusable terminal UI components (forms, tables, progress) backed by OpenTUI.

Quick Start

Use the bunli skill to create a new type-safe CLI by running "bunli init my-cli", then implement commands with defineCommand/option and run your app with bunli dev.

Frequently Asked Questions about bunli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a type-safe CLI with Bun and Zod validation?

Build type-safe CLI applications with Bun by defining commands and options using Zod-driven schemas that coerce and validate flag values before handlers execute. This ensures your command handlers receive correct types.

What's the best way to add interactive prompts and spinners to a terminal CLI?

Add interactive prompts and spinners to terminal CLIs using guided flow APIs and TUI components. Components like forms, tables, and progress bars are backed by OpenTUI for rendering terminal experiences.

How do I extend a Bun CLI framework with a plugin system?

Extend a Bun CLI framework using a plugin architecture that supports adding environment detection, shell completions, config loading, and MCP integration without rewriting the core command definitions.

Does Bunli support scaffolding new command-line projects?

Bunli supports scaffolding new command-line projects via create-bunli workflows. Run bunli init to generate a project, implement commands with defineCommand/option APIs, and test using bunli dev.

Why use Zod schemas for CLI command option definitions?

Use Zod schemas for CLI command option definitions to enforce type safety and properly coerce flag values. This validation guarantees handlers receive correctly typed inputs, preventing runtime errors.

Can I render terminal UI components like tables and forms in a Bun CLI?

Render terminal UI components like tables, forms, and progress indicators in a Bun CLI using @bunli/tui integration. These reusable components are powered by OpenTUI for terminal rendering.