ilbertt

ilbertt / parsh

Public

Build type-safe CLIs in TypeScript

bun cli cli-framework type-safety typescript
10
0
100% credibility
Found Apr 28, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

This project is a TypeScript library for building command-line interfaces with file-based organization, automatic type safety, and flexible option handling.

How It Works

1
🔍 Discover parsh

You hear about a simple way to create your own helpful command-line tools that understand exactly what you want.

2
📦 Bring it home

You easily add the pieces to your project, like picking up ingredients for a recipe.

3
📁 Sketch your menu

You organize commands by placing them in folders, like setting up sections in a restaurant menu—everything feels structured and intuitive.

4
✨ Link it all up

With one quick action, your folders turn into a smart command guide that knows all the paths.

5
🚀 Launch your tool

You start your new command-line assistant, and it springs to life, ready to handle any request perfectly.

🎉 Commands work flawlessly

Your tool responds exactly as expected every time, saving you hassle and making your work joyful.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is parsh?

parsh is a TypeScript library for building type-safe CLIs with a file-based command router. Drop command files into a directory—each path mirrors the filesystem—and define options/params via schemas like Zod or Valibot for automatic type inference in handlers. It generates a runtime tree, parses args, validates inputs, and auto-renders colored help, all headless for any TUI.

Why is it gaining traction?

Unlike yargs or Commander.js, parsh delivers end-to-end types without generics or casts—parent options inherit to children, aliases validate at compile time, and shared context injects typed services everywhere. Schema-agnostic validation and print helpers cut boilerplate, letting you focus on logic over wiring. Devs hook on the TanStack Router-inspired file discovery that scales to deep nests like AWS CLI.

Who should use this?

TypeScript devs building GitHub Actions, GitHub apps, GitHub Copilot agents or extensions, GitHub Pages, portfolios, profiles, projects, or repos. Ideal for tool authors needing nested commands with strict types, like deploy scripts or config managers, without manual arg parsing.

Verdict

Promising for type-first CLIs, with strong docs and examples despite 10 stars and 1.0% credibility score. Prototype with it now—mature enough for side projects, but wait for wider adoption before core tools.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.