Introduction

Seed CLI is a modern, batteries-included CLI framework for building powerful command-line tools with TypeScript and Bun. It provides a modular architecture where every feature is opt-in, fully typed, and designed for developer productivity.

Why Seed CLI?

• TypeScript-first — Full end-to-end type safety from arg parsing to command execution
• Bun-powered — Built for Bun's speed with native APIs where possible
• Batteries included — 15+ modules covering everything from prompts to HTTP clients
• Modular — Import only what you need; every module is a separate package
• Plugin system — Extend your CLI with reusable plugins and extensions

Quick Look

import { command, arg, flag } from '@seedcli/core'

export default command({
  name: 'greet',
  description: 'Say hello',
  args: {
    name: arg({ type: 'string', required: true, description: 'Who to greet' }),
  },
  flags: {
    loud: flag({ type: 'boolean', alias: 'l', description: 'Shout it' }),
  },
  run: async (seed) => {
    const greeting = `Hello, ${seed.args.name}!`
    if (seed.flags.loud) {
      seed.print.success(greeting.toUpperCase())
    } else {
      seed.print.info(greeting)
    }
  },
})

Packages

Seed CLI is organized as a monorepo with individual packages you can install as needed:

Umbrella Package

If you want everything in one import, use the umbrella package:

bun add @seedcli/seed

import { build, command, arg, flag, print, colors, spin } from '@seedcli/seed'

@seedcli/seed re-exports all modules with sensible naming. HTTP methods are prefixed (httpGet, httpPost), package manager functions are prefixed (detectPackageManager, installPackages), and filesystem functions use direct names (read, write, copy).

Requirements

• Bun 1.3 or later
• TypeScript 5.0+

Next Steps