Skip to content
Reference

loor-cli

A small command-line scaffolding tool for working with Loor projects locally. Studio is the primary surface — the CLI is here when you want a terminal.

What loor-cli is

loor-cli (binary: loor) is a lightweight Node CLI for scaffolding and inspecting Loor projects from your local terminal. It's not required to build with Loor — Studio is the primary surface — but it's handy when you want to:

  • Scaffold a new monorepo locally with the Loor conventions baked in.
  • Generate or update a loor.json from an existing repo.
  • Run loor-aware codegen for adding services to a project.

Published on npm as loor-cli. Requires Node 20+.

Install

# global
npm i -g loor-cli

# project-local
pnpm add -D loor-cli

loor --help

Commands

The CLI is intentionally tiny. Run loor <command> --help for full flags.

CommandWhat it does
loor initInspect the current repo and write a loor.json proposal.
loor new <template>Scaffold a fresh project from a template (next, vue, nodejs, monorepo).
loor add <service>Add a service to loor.json (mongodb, redis, r2, etc.).
loor lintValidate loor.json against the schema.
loor infoPrint resolved project metadata.

Studio vs CLI

The Studio web app does everything the CLI does, plus the things the CLI can't: AI-driven editing, dev-server orchestration, deployments, domain management. The CLI is for moments when you want a terminal — it doesn't replace Studio, it complements it.

If you're not sure which to use, use Studio. Reach for the CLI when you have a strong reason (offline scaffolding, custom CI flows, an existing monorepo).