cli-builder
Guide for building TypeScript CLIs with Bun. Use when creating command-line tools, adding subcommands to existing CLIs, or building developer tooling. Covers argument parsing, subcommand patterns, output formatting, and distribution.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Guide for building TypeScript CLIs with Bun. Use when creating command-line tools, adding subcommands to existing CLIs, or building developer tooling. Covers argument parsing, subcommand patterns, output formatting, and distribution.
How to use
Utwórz plik TypeScript dla swojego narzędzia (np.
scripts/my-tool.ts) i dodaj shebang#!/usr/bin/env bunna początku, aby móc uruchamiać plik bezpośrednio z wiersza poleceń.Rozpocznij od najprostszej wersji: pobierz argumenty z
process.argv.slice(2), sprawdź pierwszą wartość jako komendę i wyświetl pomoc, jeśli użytkownik poprosi o nią lub nie poda żadnej komendy.Aby obsługiwać flagi i opcje (np.
-n,--verbose), użyj modułuparseArgsz Node'a (dostępny w Bun). Zdefiniuj opcje z ich typami, krótkimi aliasami i wartościami domyślnymi.Odczytaj wartości flag z obiektu
valuesi argumenty pozycyjne z tablicypositionalszwróconej przezparseArgs. Użyj ich do sterowania zachowaniem narzędzia.Jeśli planujesz wiele komend, zastosuj wzorzec rejestru komend zamiast długiego łańcucha instrukcji warunkowych – ułatwi to rozszerzanie narzędzia.
Uruchom narzędzie poleceniem
bun scripts/my-tool.ts nazwa-komendyi testuj różne flagi oraz argumenty, aby upewnić się, że parsowanie i logika działają poprawnie.