The Cosmos CLI

A CLI tool for scaffolding modern web applications from opinionated templates.

Features

• Simple environment variable validation with helpful error messages
• Bitbucket integration for private template repositories
• Interactive CLI prompts for project setup
• Support for Next.js and Vite templates
• Clean, readable codebase with meaningful function names

Setup

Environment Variables

Before using the CLI, you need to configure your Bitbucket credentials:

1. Copy the environment template:

   cp env.example .env

2. Edit .env and add your Bitbucket credentials:

   BITBUCKET_USERNAME=your_bitbucket_username
   BITBUCKET_API_TOKEN=your_bitbucket_app_password

3. Generate a Bitbucket App Password:

   • Go to Bitbucket App Passwords
   • Create a new app password with repository read permissions
   • Use this token as your BITBUCKET_API_TOKEN

Usage

# Build the CLI
pnpm build

# Run directly
node dist/index.js

# Or link globally
pnpm run link
create-a-cosmo

Development

# Watch mode
pnpm dev

# Build
pnpm build