CLI reference

Every command and option in @luci-dev/cli (luci), from init, serve and capture to skills, map and doctor, with what each one does.

Run commands without installing globally using npx @luci-dev/cli@latest <command>, or install globally:

bash
npm install -g @luci-dev/cli

Installing globally provides both luci and luci-dev. Requires Node 18 or later.

Setup and project health

luci init [--dry-run] [--force] [--yes | -i] [--agents <list>] [--toolbar]
Initialize .luci/, Global Brain, starter skills, design baseline and agent files. --agents accepts codex, gemini, copilot, generic or all
luci start
Print the active task and project context needed to resume work
luci update
Refresh auto-detected stack sections, brain.json, agent files and skill catalog
luci doctor [--json]
Check the installation and project setup and report fixes
luci import [--dry-run]
Migrate a project from ai-brain/ onto Luci
luci intake <file...> [--dry-run]
Fit a PRD and supporting docs into .luci/ project memory

Dev toolbar and live bridge

luci serve [--port <n>]
Start the local bridge (127.0.0.1, default port 4545) for feedback and .luci/design/ captures
luci toolbar [remove] [--port <n>] [--dry-run]
Add or remove the localhost-only dev toolbar loader in your app's root HTML or layout

Design captures and baselines

luci capture
List design captures saved in .luci/design/
luci capture checks
List recent design check runs
luci capture rule <file>
Propose a project rule from a component capture into .luci/memory/proposed/
luci capture baseline [--stitch] [--tailwind] [--tailwind-v3] [--css-vars]
Rebuild project.system.*.design.md from project stylesheets, with optional DESIGN.md, Tailwind v4 theme.css, tailwind.config.js or tokens.css output
luci capture compare <a> <b>
Print part-by-part differences between two saved component captures
luci capture crawl <urls...> [--stitch] [--base <url>]
Crawl routes in one pass and merge into site-level systems in .luci/design/
luci capture layout <file>
Print the computed flex/grid layout tree of a component or section capture

Skills, packs, tasks and code map

luci skills [category]
List skills in Luci's library and your personal library
luci skills search <query>
Search skills by keyword
luci skills recommend <task>
Recommend skills for a task with reasons
luci skills use <task> [--project] [--budget <tokens>] [--full] [--inject]
Load matching skills (--inject writes .luci/local/active-task.md)
luci skills select <name...> [--reason <text>]
Select library skills for this project
luci skills deselect <name...>
Remove skills from this project
luci skills selected
List selected skills for this project
luci skills add <github-link|folder|file> [--project] [--category <c>] [--name <n>] [--yes]
Convert and add a skill (GitHub links fetch from GitHub)
luci skills mine
List your personal skill library
luci skills share <name>
Copy a personal skill into the project for teammates
luci skills lint [folder] [--levels]
Validate skills against the Luci Skill Standard
luci skills pin|unpin|block|unblock <name...>
Set skill ranking preferences
luci skills prefs
Show pinned and blocked skills
luci skills review [name] [--approve | --reject] [field...]
Review drafted ranking fields
luci skills licenses [--apply]
Check licences of personal skills at their source
luci skills index
Rebuild the personal skill library index
luci packs [show | add <name...> | remove <name...>]
Inspect, add or remove curated skill packs (ui, motion, marketing, design-system, design-system-build)
luci task [done]
Show the active task or archive it when finished
luci map [--update | --install]
Check, update or install the Graphify code map (graphify-out/)
luci benchmark [--json]
Show saved local evaluation reports from eval/
luci version (-v, --version)
Print the CLI version
luci help (-h, --help)
Print command usage