@luci-dev/cli
v0.5.8
Published
Memory, skills, design capture and feedback for AI coding agents. Local only.
Readme
Luci
Design control for AI coding agents. Luci gives your coding agent the project's memory, the right design skills, exact measurements from any page, and feedback pinned to the element. It runs on your machine.
Free and MIT licensed · No account · No telemetry · Works with Claude Code, Cursor, Codex, Gemini CLI and GitHub Copilot.
npm install -g @luci-dev/cli
luci init
luci serveWhat it does
- Memory.
luci initcreates a.luci/folder in your project: goal, stack, commands, rules, decisions and the active task. It also writes a short section into your agent's own file (CLAUDE.md,AGENTS.md,.cursorrules,GEMINI.md, Copilot instructions) so every session starts from the same context. - Skills. A ranked library of UI/UX, motion and front-end skills. Luci loads only the ones that fit the current task, so the agent's context stays small.
- Dev toolbar. Luci inside your running app (tested in Chrome and Edge):
- Feedback: click an element (or tap it on a phone), write what should change, and copy one prompt with every note.
- Layout: resize, move and space elements on the live page, then send the plan to your agent.
- Capture: take a component, text, color or spacing as a design file the agent can read.
- MCP server.
luci-mcplets the agent read the project context, your notes and saved captures itself.
Requirements
Node.js 18 or later.
Get started
Install Luci once:
npm install -g @luci-dev/cli(Fallback for CI or one-off runs without installing:
npx @luci-dev/cli@latest <command>. On Windows, if PowerShell blocksluci, use Command Prompt or runluci.cmd.)Set up your project. In your project folder:
luci initIt asks for the project's goal, suggests skills and rules, and offers to add the dev toolbar to your app (press Enter for yes).
Start the toolbar's connection. Leave this running while you work:
luci serveOpen your app on this machine in Chrome or Edge. Luci's button is in the bottom corner. Notes and captures go into
.luci/, where your agent reads them.Optional: connect your agent to
luci-mcp. Claude Code, from the project folder:claude mcp add luci-mcp -- npx -y @luci-dev/mcp@latestFor other agents, add a stdio MCP server that runs
npx -y @luci-dev/mcp@latestin the project folder. Copying the prompt from the toolbar works without it.
Common commands
| Command | What it does |
| :--- | :--- |
| luci init | Set up Luci in this project |
| luci serve | Connect the dev toolbar to this project |
| luci toolbar | Add the dev toolbar to your app (luci toolbar remove takes it out) |
| luci start | Show the active task and the context an agent needs |
| luci doctor | Check the install and this project, and say how to fix what is wrong |
| luci update | Refresh the files Luci wrote into this project |
| luci skills use <task> | Load the skills that fit a task |
| luci --version | Show the installed version |
luci --help lists everything. The command reference explains every command and option, the dev toolbar's tools and keys, the Chrome extension, and the tools your agent can call.
Updating
Luci never checks for updates on its own. A new version reaches you when you fetch it:
| How you run Luci | How to update |
| :--- | :--- |
| npx @luci-dev/cli@latest … | Nothing to do: @latest fetches the newest version every time. |
| Installed with npm install -g @luci-dev/cli | npm install -g @luci-dev/cli@latest |
| luci-mcp through npx -y @luci-dev/mcp@latest | Nothing to do: restart your agent to start the new version. |
After updating:
- Dev toolbar: stop
luci serve(Ctrl+C), start it again, and reload your app. The toolbar comes from the Luci you have installed, so the restart brings the new one. You do not need to runluci toolbaragain. - Project files: run
luci doctorin each project. If it says a Luci section is out of date, runluci update. It refreshes Luci's own files (.luci/context, agent files, skill catalog) and keeps your rules, decisions and notes.
luci update refreshes a project's files; it does not update Luci itself.
Privacy
- Everything runs on your machine.
luci servelistens on 127.0.0.1 only. - No telemetry, accounts or API keys.
- Luci goes online only when you run a command that needs the network:
luci skills add <github-link>,luci skills licenses,luci map --install(downloadsuvand Graphify after asking), orluci capture crawl <urls...>.
Links
MIT licensed.
