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/cliInstalling 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.--agentsacceptscodex,gemini,copilot,genericorall 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 port4545) 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.mdfrom project stylesheets, with optionalDESIGN.md, Tailwind v4theme.css,tailwind.config.jsortokens.cssoutput 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 (
--injectwrites.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