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