ilse-design

中文文档
0.11.0发布于 2026/11/04PolyForm-Shield-1.0.0TypeScriptES Module构建来源已验证

The designer's eye inside the code agent: point at what's wrong in your running app, or adjust it like in Figma — your own coding agent changes the code.

原始使用文档
文档目录7 节
  1. What you can do
  2. What you need
  3. Try it
  4. What it costs
  5. Go deeper
  6. Why "Ilse"
  7. Contributing

Ilse

English · Português

The designer's eye inside the code agent.

You open your app in the browser, point at what's wrong and say how it should be — or adjust it right there, like in Figma. Your AI coding agent changes the code. You see the result on the page, and keep it or undo it.

Side project, in beta. Made by a designer, for designers who work with code agents. Free to use, with the code open to read.

What you can do

  • Point and say. Click an element, select a piece of text or draw an area, and write what should change: "more space between the cards", "this title should be stronger".
  • Adjust it yourself. A property panel like Figma's: size, layout, spacing, typography, colors, borders. You see the change live before sending it.
  • Edit text and remove things. Retype a text right in the panel, or remove an element.
  • Every screen size. Open the page at phone, tablet or desktop width, with rulers, and adjust each one with the same toolbar.
  • Move things around. Drag to reorder, move into or out of a container, resize.
  • Draw it. Sketch on the page with the pencil, or paste a screenshot as a reference.
  • Undo anything. ⌘Z puts the code back exactly as it was. No need to ask the AI to revert.
  • Keeps CI green. After each change Ilse runs your project's typecheck and the tests that cover it. What the change broke, the agent fixes before it's called done.

What you need

  • A React project that runs on your computer (Next.js, Vite…).
  • An AI coding agent installed and logged in: Claude Code, Codex, Cursor CLI or Gemini CLI.

Ilse uses your agent and your account. It has no account, key or server of its own, and nothing leaves your machine.

Try it

In your project's folder — no need to start the app first — run:

npx ilse-design@latest

Ilse is on npm as ilse-design and needs Node.js 18 or newer. @latest makes sure you get the newest version, even if an older one is installed on your machine.

Ilse starts your dev server (npm run dev) behind itself and opens your app at its usual address — http://localhost:3000, or whatever port it uses — with the toolbar on top. Logins, SSO and callbacks keep working. The first run asks a few questions and takes about a minute. Next time, just ilse if you installed it.

Prefer to run the dev server yourself? --separate opens Ilse on its own address, localhost:4700. More ways: the Vite plugin, the bookmarklet or the Chrome extension (experimental).

Not comfortable with the terminal? Ask your agent: "Install and run Ilse in this project — see https://github.com/idantas/ilse".

What it costs

Ilse runs on your agent's plan, so it uses that plan's limits. It always picks the cheapest way that works:

  • Panel adjustments that map to a class in your code are made by Ilse itself — no AI, instant, nothing from your plan.
  • Small requests go to a fast, cheaper model: a few seconds.
  • Bigger ones (new screens, structure) go to the full agent — the most expensive step, so it's used only when needed.

Go deeper

  • How it works — how Ilse finds the code, the cost ladder, models, safety checks, usage limits, undo and commits.
  • Reference — commands, settings, connecting your agent over MCP, logs, compatibility.
  • AGENTS.md — for contributors and their agents.

Why "Ilse"

AI freed designers from the execution bottleneck, but craft still needs human judgment. Ilse is the designer's eye inside the agent: you point at what's wrong, the agent fixes it, you approve.

"Design is a tool for improving humanity." — Ilse Crawford

Contributing

Issues and pull requests are welcome — see CONTRIBUTING.md. Security problems go privately: SECURITY.md.

PolyForm Shield 1.0.0: free to use, change and share — just not to build a product that competes with Ilse. Versions up to 0.5.1 were MIT; see NOTICE.

版本与发布记录

ilse-design 共发布 25 个版本,首次发布于 2026/04/11;过去 12 个月发布了 25 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.11.0latest2026/11/041 天前
0.10.12026/10/306 天前
0.10.02026/10/306 天前
0.9.02026/10/288 天前
0.8.02026/10/279 天前
0.7.02026/10/2115 天前

其他发布通道:beta → 0.3.0-beta.8,next → 0.5.0-beta.1。

关于 ilse-design 的常见问题

ilse-design 是什么?

The designer's eye inside the code agent: point at what's wrong in your running app, or adjust it like in Figma — your own coding agent changes the code.

如何安装 ilse-design?

在项目目录运行 npm install ilse-design,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ilse、ilse-mcp、ilse-design,可以用 npx ilse 直接运行。

ilse-design 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

ilse-design 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

ilse-design 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

ilse-design 可以商用吗?

ilse-design 使用 PolyForm-Shield-1.0.0 许可。声明的许可为 PolyForm-Shield-1.0.0,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

ilse-design 还在维护吗?

最新版本 0.11.0 发布于 2026/11/04(1 天前);至今共发布 25 个版本,其中过去 12 个月发布了 25 个;首次发布于 2026/04/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。