Rempts

The modern CLI framework designed exclusively for Bun. Build powerful, type-safe command-line tools that leverage Bun's unique capabilities and compile to efficient single-file executables.

What is Rempts?

Rempts is a comprehensive CLI development ecosystem built specifically for the Bun runtime. It provides a type-safe foundation for creating sophisticated command-line applications with automatic type inference, extensible plugin architecture, and seamless integration with Bun's ecosystem.

// Types flow automatically from schema validation
handler: async ({ flags, context }) => {
  // flags is fully typed, context provides plugin stores
}

// Powerful plugin system with Zustand stores
const cli = await createCLI({
  plugins: [configPlugin(), aiDetectPlugin()]
})

commands/
├── build/
│   └── cmd.ts
├── deploy/
│   └── cmd.ts
└── db/
    ├── migrate/
    │   └── cmd.ts
    └── seed/
        └── cmd.ts

handler: async ({ shell, prompt, spinner, terminal, context }) => {
  // Bun Shell, interactive prompts, progress indicators, plugin context
}

Quick Start

# Scaffold a new CLI project
bunx @reliverse/rempts my-cli
cd my-cli

# Run your CLI directly
bun run cli.ts --help

# Build optimized executable
bun dler build

# Scaffold a new CLI project
npx @reliverse/rempts my-cli
cd my-cli

# Run your CLI directly
bun run cli.ts --help

# Build optimized executable
bun dler build

Why Rempts?

Built for Bun's Ecosystem

Rempts harnesses Bun's unique advantages for CLI development:

• Native TypeScript - Execute .ts files directly without compilation overhead
• Bun Shell - Integrated shell operations with automatic process management
• Rapid Startup - Sub-millisecond cold starts for instant CLI responsiveness
• Single Executables - Compile to standalone binaries with zero runtime dependencies
• Built-in Testing - Leverage Bun's fast test runner for comprehensive CLI testing

Zero-Config Type Safety

Automatic type inference eliminates manual type annotations while maintaining full compile-time safety:

import { defineCommand, option } from '@reliverse/rempts-core'
import { z } from 'zod'

// Rempts infers everything automatically
export default defineCommand({
  name: 'deploy',
  options: {
    env: option(
      z.enum(['dev', 'staging', 'prod']),
      { description: 'Target environment' }
    )
  },
  handler: async ({ flags }) => {
    // TypeScript knows flags.env is 'dev' | 'staging' | 'prod'
    switch (flags.env) {
      case 'dev':     // ✅ Autocompleted
      case 'staging': // ✅ Autocompleted
      case 'prod':    // ✅ Autocompleted
    }
  }
})

import { defineCommand, option } from '@reliverse/rempts-core'
import { type } from 'arktype'

// Rempts infers everything automatically
export default defineCommand({
  name: 'deploy',
  options: {
    env: option(
      type("'dev'|'staging'|'prod'"),
      { description: 'Target environment' }
    )
  },
  handler: async ({ flags }) => {
    // TypeScript knows flags.env is 'dev' | 'staging' | 'prod'
    switch (flags.env) {
      case 'dev':     // ✅ Autocompleted
      case 'staging': // ✅ Autocompleted
      case 'prod':    // ✅ Autocompleted
    }
  }
})

Validator Agnostic

Freedom to choose your preferred validation library with Standard Schema v1 compatibility:

import { z } from 'zod'
import * as v from 'valibot'
import { type } from 'arktype'

// Mix and match validators seamlessly
options: {
  email: option(z.string().email()),
  port: option(v.number([v.minValue(1), v.maxValue(65535)])),
  env: option(type("'dev'|'staging'|'prod'"))
}

Complete Development Ecosystem

Rempts provides a comprehensive ecosystem for CLI development:

• @reliverse/rempts - Project scaffolding tool with template selection
• @reliverse/rempts-core - Type-safe CLI framework with file-based command discovery
• @reliverse/rempts-utils - Shared utilities (prompts, spinners, colors, validation)
• @reliverse/rempts-test - Testing utilities for CLI applications
• @reliverse/rempts-plugin-* - Extensible plugin system for advanced functionality

Next Steps