@buildepicshit/cli

The core orchestrator library and CLI binary for Build Epic Shit.

Install

npm install @buildepicshit/cli

See the root README for full API documentation, examples, and usage guide.

What's in this package

• Orchestrator API — cmd(), par(), seq(), health checks, tokens, identity system
• Framework presets — nextjs(), docker(), esbuild(), hono(), tsx(), etc.
• bes CLI binary — reads bes.config.ts and turns exported functions into CLI commands

Exports

// Main entry point
import { cmd, par, seq, health, fromEnv, fromFile, compute } from "@buildepicshit/cli"

// Presets
import { nextjs, dockerCompose, esbuild, tsx, hono, drizzle } from "@buildepicshit/cli/presets"

Development

pnpm dev          # Watch mode (esbuild)
pnpm build        # Production build
pnpm test         # Run tests
pnpm typecheck    # Type checking

Architecture

src/
├── bes.ts                    # CLI entry point (commander)
├── config-loader.ts          # bes.config.ts discovery and loading (jiti)
├── completion.ts             # Shell tab-completion (omelette)
├── orchestrator/
│   ├── index.ts              # Public API surface
│   ├── core/
│   │   ├── command.ts        # ICommand implementation (immutable builder)
│   │   ├── compound.ts       # par/seq implementation
│   │   ├── health-check.ts   # Health check factories
│   │   ├── token.ts          # Token resolution (compute, fromEnv, fromFile)
│   │   └── types.ts          # All TypeScript interfaces
│   ├── presets/
│   │   ├── nextjs.ts         # Next.js preset
│   │   ├── docker.ts         # Docker/docker-compose preset
│   │   ├── drizzle.ts        # Drizzle ORM preset
│   │   ├── esbuild.ts        # esbuild preset
│   │   ├── hono.ts           # Hono preset
│   │   └── node.ts           # tsx/nodemon presets
│   ├── runner/
│   │   ├── event-bus.ts      # Event emission for process lifecycle
│   │   ├── process.ts        # Child process spawning
│   │   └── runtime-context.ts
│   ├── logger/
│   │   └── logger.ts         # Structured logging
│   └── utils/
│       └── dna.ts            # Identity/port allocation (deterministic hashing)