@loop-kit/cli

loop-kit CLI is a self-starting dev/build tool that makes it trivial to run and build TypeScript projects with Vite and vite-node.

It’s designed to just work out of the box: no boilerplate, no setup — the CLI auto-inits your project with sensible defaults if needed.

Features

• Dev Run : Run TypeScript entries instantly with vite-node --watch.
• Build : Use Vite’s SSR build mode with zero config.
• Auto Init : If missing, the CLI will create:
• package.json (type: module)
• tsconfig.json with NodeNext + JSX defaults
• .gitignore
• Dev dependencies: vite, vite-node
• Upgrade in Place : One-command self-upgrade via npm.
• Cross-platform : Works reliably on macOS, Windows, and Linux.

Installation

npm i -g @loop-kit/cli

Requires Node 20+ with native ESM support.

Usage

loop <entry>          # Dev-run with vite-node (watch, auto-init)
loop run <entry>      # Same as above
loop build <entry>    # Vite build --ssr into dist/ (auto-init)
loop upgrade          # Upgrade CLI via npm
loop version          # Show CLI version

Examples

# Run a TypeScript file with vite-node
loop index.ts

# Build a server entrypoint
loop build src/server.ts --outDir build --minify false

# Upgrade the CLI itself
loop upgrade

Philosophy

The CLI is designed to bootstrap itself :

• If your project has no config, loop will scaffold just enough to make things run.
• If dependencies are missing, loop installs them.
• It aims to reduce friction on fresh environments — ideal for experiments, demos, or quickly starting new projects.

The long-term goal is for loop-kit itself to be self-hosting : built and extended entirely with loop.

Roadmap

• Replace hardcoded bootstrapping with loop-kit-native utilities .
• Integrate @loop-kit/common and @loop-kit/platform.
• Eventually power richer workflows (Live/UseGPU integrations, declarative config).

License

MIT © Isaac Harvey / Infinite Loop Technologies