Package Exports

@adam-leigh/hyper
@adam-leigh/hyper/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@adam-leigh/hyper) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Hyper CLI

Helper tools to prime AI-assisted development.

Overview

The hyper CLI is an internal tool for accelerating developer workflows with utility-rich CLI commands. This MVP focuses on project initialization and preparation for AI-assisted development.

Features

hyper init: Initialize a project with AI-ready scaffolding
- Validates current working directory contains a package.json
- Creates required folders and files for AI-assisted development
- Automatically downloads structure from Supabase
- Beautiful CLI experience with styled output
hyper cp: Copy file(s) to clipboard in markdown format
- Support for individual files or entire directories
- File filtering with glob patterns
- Formats code with language-specific markdown blocks
- Silent operation with optional verbose logging

Installation

Local Development

# Clone the repository
git clone https://github.com/adam-leigh/hyper-cli.git
cd hyper-cli

# Install dependencies
npm install

# Build the project
npm run build

# Create a symlink to use the CLI locally
npm link

Usage

# Initialize a project with AI-ready scaffolding
hyper init

# Show help
hyper --help

# Copy files or directories to clipboard
hyper cp src/utils/logger.ts

# Copy files with filtering
hyper cp src/ --filter "*.ts" --verbose

Structure

The CLI is built with a modular architecture:

src/
├── commands/
│   ├── init/
│   │   ├── index.ts       # Command handler
│   │   ├── schema.ts      # Input validation
│   │   ├── hooks.ts       # Reusable logic
│   │   ├── utils.ts       # Helper functions
│   │   ├── types.ts       # Type definitions
│   │   └── ui.ts          # CLI output
│   ├── cp/
│   │   ├── index.ts       # Command handler
│   │   ├── schema.ts      # Input validation
│   │   ├── hooks.ts       # Reusable logic
│   │   ├── utils.ts       # Helper functions
│   │   ├── types.ts       # Type definitions
│   │   └── ui.ts          # CLI output
├── utils/
│   ├── supabase/
│   │   ├── client.ts      # Supabase client
│   │   └── types.ts       # Supabase types
├── types/
└── index.ts               # CLI entry point

Development

# Watch for changes during development
npm run dev

# Run linting
npm run lint

# Run tests
npm run test

Requirements

Node.js >= 18.0.0
A Supabase project with the required tables (directories, files)

Environment Variables

Create a .env file with:

SUPABASE_URL=your-supabase-url
SUPABASE_ANON_KEY=your-supabase-anon-key