Luci curled up asleep

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.

npx @luci-dev/cli@latest init
Star on GitHub

Free and MIT licensed · No account · No telemetry

Works with Claude Code, Cursor, Codex, Gemini CLI and GitHub Copilot.

One memory for every agent.

How memory works
~/my-app

luci init

--agents codex
project memory
.luci/
Claude Code
CLAUDE.md
Cursor
.cursorrules
Codex
AGENTS.md
design baseline
.luci/design/
Every agent reads the same memory.

Set up. One command gives the project a shared memory in .luci/ and links it into every agent's instruction file.

Direct your agent from your running app.

Explore the Devtool
localhost:3000

1 note on /

P1-A1

“Shorten to ‘Start free’.”

element
Start your free trial
component
<Hero>
source
Hero.tsx:42
get_feedback_prompt · 1 page, 1 item

Feedback. Click an element and say what should change. Luci pins the note to its component and source line.

Capture the design of any website.

example.com

Start free

button
height
44px
padding
0 20px
radius
9999px
background
--accent-primary
label
Inter 600 · 15/24
states
hover · focus · active
Added to the basket

Component. Click any element. Luci records its parts, tokens and states.

Agents are fast. They also guess.

They forget.

Rules and decisions get repeated every session.

They guess the design.

A screenshot gives estimates, not values.

They misread feedback.

"Make the button bigger" could mean any button.

They drift.

Nobody checks the result against the design.

One loop, four steps.

Show the design, direct the change, check the result, and keep what was decided.

Capture exactly what you pick.

Pick a component, text style, colour or spacing value on any page. Luci writes a design file with measured values, including hover and focus states.

Four tools
Component, Text, Colour and Spacing.
Every state
Hover, focus, active and disabled.
One basket
Collect picks across pages, export one file.
Your tokens
Rewrite a capture onto your own tokens.
How capture works

Point at it. Luci writes the prompt.

Pin a note on the exact element, or drag the layout into place. Luci turns it into one prompt, with the source file for each item.

Source lookup
Component and file in React, Vue and Svelte.
One prompt
Notes from several pages, each with an ID.
Layout mode
Resize, move and insert parts, or sketch a page.
You decide
Only you mark a note done.
How feedback works

Check what the agent built.

Luci captures the built component the same way and compares it with the design, part by part.

Part by part
Styles, states, anatomy, motion and accessibility.
One sentence each
Every difference can become a feedback note.
Auto re-check
Runs again when the page changes.
How the design check works

Agents that start informed.

Rules, decisions and the current task live in a .luci/ folder. Every agent reads them at the start of a session.

Conflicts flagged
Contradicting rules, with file and line.
Right skills
Only what the task needs, within a token budget.
Built for UI
A skill library for UI, UX and front-end work.
How memory works

Start in three steps.

Needs Node 18 or later.

Read the quickstart
1
npx @luci-dev/cli@latest init

Detects your stack, creates .luci/ and sets up your agents.

2
luci serve

Opens your project with the Luci toolbar.

3
Pick something

Pick something. Your agent can read it straight away.

Everything stays on your machine.

  • No account, no API key, no cloud storage.
  • No telemetry. Luci makes no outside calls.
  • Captures and notes are plain files in your project.
  • This site does not track you either.

Free and open source.

Luci is MIT licensed. Star the repository to follow releases, or open an issue to report a problem.

Forever free. One dinner for Luci, should you wish.

Questions.

Is Luci free?
Yes. It is MIT licensed and has no paid plan.
Which agents does it work with?
Claude Code, Cursor, Codex, Gemini CLI and GitHub Copilot.
Which frameworks?
Capture works on any website. Finding the source file works in React, Vue and Svelte projects.
Does Luci send my code or designs anywhere?
No. Everything is stored as files on your machine.
Does it copy other sites?
No. It measures styles and structure. It does not copy images or text. Use captures as reference, and respect each site's rights.
Which systems are supported?
Windows and macOS are tested. Linux is not yet tested.
Where is the Chrome extension?
It is in review. Ask to be notified.
Why "beta"?
Luci is feature complete and still being tested in real projects.
Who is Luci?
A ginger tabby. The tool is named after him.
Luci watching

Luci is ready. Pick something.

npx @luci-dev/cli@latest init
Star on GitHub