Kilo OpenDesign

Design With
Kilo in
OpenDesign.

How to design interfaces with Kilo Code in OpenDesign: the model you choose, your own rules and modes, one product-page task from screenshot to reviewed file, and the limits to know before you start.

On This Page Example
  1. Example
  2. Fit
  3. Compatibility
  4. Setup
  5. Workflow
  6. Resources
  7. Limitations
  8. FAQ

One Complete Kilo Design Task

One Kilo Design Task: Brief Through Interface

The task runs from the brief and constraints you hand over, through the artifact Kilo returns, to the checks you still run before calling it done. The interface below is an illustrative example made for this page, not a recorded Kilo run.

1Design Brief and Constraints

Brief

Using the attached screenshot, design an outdoor brand product detail page: gallery, price, size and colour choices, add to bag, related products. Desktop and phone.

  • Design systemAlbert Sans and one green accent on the OpenDesign paper canvas
  • Breakpoints1440px desktop and 390px mobile, with no horizontal scroll
  • InteractionsGallery thumbnails, option selection, add to bag, related-products scroll
  • OutputA single self-contained HTML file carrying stable data-od-id hooks

2Who Does What: You, Kilo, OpenDesign

  • You

    You write the brief, choose the design system and set the acceptance criteria.

  • Kilo

    Kilo plans the layout, writes HTML, CSS and JavaScript, then revises on request.

  • OpenDesign

    OpenDesign supplies the design system and skill, renders the preview, and keeps each version as a project file.

  • Review

    Before handoff, you check visual hierarchy, 8px-grid spacing, both breakpoints and every interaction.

3Kilo's Artifact: Product Page at 1440px and 390px

Kilo's Artifact: Product Page at 1440px and 390px — Desktop
Illustrative example

4Review Before Handoff

Layout

Grid and Spacing

Gallery and info align to the 8px grid; at 1440, the info column stays within the gallery height.

Hierarchy

Visual Hierarchy

Name and price come first, then options; the accent is reserved for the add-to-bag button.

Responsive

Mobile Layout

Mobile order: gallery, name and price, options, a full-width button; related products scroll.

Interaction

Interaction Checks

Interactions to test: switch thumbnail, choose size, add to bag, scroll related items.

Fit

Where Kilo Fits — and Where It Doesn't

Kilo Fits When

  • Model choice for screenshot → UI. Point Kilo at the vision-capable model that best converts a reference image into responsive markup, then compare the result to that image.
  • BYOK across providers. Use your own keys for Anthropic, OpenAI, Google, OpenRouter and others, or Kilo's gateway, keeping cost and credentials in your hands.
  • Modes, custom rules, MCP. Architect mode for planning, Code mode for building, custom rules for conventions, and the Figma MCP server for real design context.
  • Open source. Prompts and context payloads are inspectable, nothing is hidden, and Kilo runs in your IDE or CLI.

Choose Another Workflow When

  • You need editable vector files. What comes back is HTML, not an editable design document. Look to a separate vector workflow for the asset format you require.
  • There is no reference and no constraint. With no design system or examples, output drifts generic; write the brief first.
  • The required credential is missing. Kilo needs either your own provider API key (BYOK) or Kilo's gateway. OpenDesign neither provides nor proxies credentials.
  • Your team works in OpenCode or Aider. Those agents have their own pages; the workspace carries over while setup differs. See related agents.

Compatibility

Kilo Requirements Before You Start

This page covers Kilo connected through the OpenDesign desktop app. References were checked on 6 September 2026.

Tool ScopeKilo, by Kilo Code, Inc.

Kilo Code, by Kilo Code, Inc., is an open-source AI coding agent. It works in VS Code, JetBrains IDEs and the terminal: reading your codebase, editing files and running commands. The subject here is designing interfaces with Kilo through OpenDesign, not Kilo's own interface. OpenDesign's setup notes list the available agents.

Accounts and AuthenticationA provider API key you supply (BYOK), or Kilo's

Your own provider API key (BYOK) or Kilo's gateway. Authenticate with your own provider key (BYOK) or Kilo's gateway; credentials remain on your machine. No quota or price is promised here.

System and VersionsDesktop app or source

Desktop builds live on the download page. Node.js and pnpm requirements in the source quickstart apply when running from source, not when installing a desktop package. Minimum compatible Kilo version: not verified on this page.

Connection CheckThe success signal

Use the connection instructions your installed version displays, then try a small task. Check that Kilo completed it and the artifact opens. Downloading alone does not prove a working connection.

Start with the desktop app

Kilo Setup in Three Steps

Start with the download, complete Kilo setup for your installed version, then test one small result. Following this path does not require building OpenDesign from source.

  1. 1

    Download the OpenDesign Desktop App

    Pick the package for your machine, install it, and launch the app.

    Download OpenDesign
    CHECKPOINT
    The desktop app opens. If you already have it, continue to the next step; no second download is needed.
  2. 2

    Prepare Your Kilo Connection

    Use the Kilo instructions that match your installed version. Sign in with your own provider key (BYOK) or Kilo's gateway; credentials stay local to your machine.

    Kilo Code documentation
    # 1. Install the Kilo Code extension from the VS Code
    #    (or JetBrains) marketplace, or install the CLI.
    
    # 2. Open your project and sign in / add a provider key
    cd your-project
    kilo              # connect your provider (BYOK) or Kilo's gateway

    Taken from the Kilo setup notes in the published guide; for the current command, check the vendor documentation.

    CHECKPOINT
    Make sure the agent and account are the ones you intended. If unavailable, review compatibility before attempting a bigger task.
  3. 3

    Run One Small Kilo Task

    Start with a brief small enough to judge the whole loop, including one revision.

    Starter brief

    Build a settings screen with a profile form and save confirmation. Follow my design rules. Check it at desktop and mobile widths.

    CHECKPOINT
    Open the result, test the save state, then ask for one specific change. The generated file starts the review; it does not finish it.

To run OpenDesign from source instead, see the technical quickstart.

The Kilo design workflow

Five Steps Through a Kilo Design Task

One product page, tracked from the opening brief to a file you have actually verified. Each step names your input, what Kilo does, what OpenDesign contributes and the check that closes it.

  1. 1

    Design Brief

    Keep it plain and short — three to six lines. Say who the screen is for, what it must do and which platforms matter.

    • YouYou write the brief, and attach a reference screenshot when one exists.
    • KiloReads your brief and the project’s instruction file, and asks rather than guesses when a detail is ambiguous.
    • OpenDesignSupplies the project, the prompt surface and the skill matching the artifact type.
    • CheckCheck that the brief spells out the acceptance criteria. Writing them now costs less than fixing the file later.
  2. 2

    Design Constraints

    A design system plus a handful of firm rules — the difference between output that carries your brand and output that could belong to anyone.

    • YouChoose a design system, then name your breakpoints and any components that must appear.
    • KiloLoads the DESIGN.md tokens and posture rules into context before writing any markup.
    • OpenDesignShips the design-system library and binds your chosen system into the skill template.
    • CheckVerify the tokens match your brand: one accent, correct fonts, correct radius.
  3. 3

    Generate the Interface

    Kilo writes one self-contained HTML file — layout, styles, interactions, stable hooks.

    • YouYour job here is to wait or answer a clarifying question. There is nothing to configure.
    • KiloPlans the sections, writes the HTML, CSS and JavaScript, runs the file, repairs what fails.
    • OpenDesignSaves the artifact to the project folder and indexes it so it can be previewed.
    • CheckNothing yet — judge it rendered, not by reading the source.
  4. 4

    Preview

    OpenDesign renders the file at the widths you specified. Judgment happens here, on the preview.

    • YouChange widths, exercise the interactions, and comment on specific elements.
    • KiloReads the comments you left on the preview and prepares the next revision.
    • OpenDesignRenders the preview and exposes data-od-id targets so comments and edits can attach to them.
    • CheckCheck hierarchy, contrast, overflow at 390px and focus states, and ask whether the accent stays sparing.
  5. 5

    Revise and Verify

    Ask for changes by pointing at elements in the preview. Each revision arrives as a new file; nothing is silently overwritten.

    • YouConvert comments into requests and decide when the task is finished.
    • KiloApplies changes in place and runs the file again.
    • OpenDesignKeeps versions side by side and, at the end, exports an image or the HTML.
    • CheckRe-check the changed area only, then the full page once per breakpoint.

Resources

Kilo Design Resources

Limitations

Where Kilo Stops: Limits, Manual Checks, Fallbacks

  • ScopeKilo is model-agnostic and BYOK across many providers, with Architect/Code/Debug/Ask modes and MCP support, so the model choice and the credentials stay yours. This page is about Kilo as an agent wired into OpenDesign, not about every Kilo feature.
  • Usage LimitsCost and usage limits track whatever credential you authenticate with — your own provider API key or Kilo's gateway. No free-quota claim is made here.
  • NetworkFiles living in your project do not make inference offline. Before you share sensitive inputs, review the agent’s provider settings and data policies.
  • Output Is HTMLThe artifact is an HTML file; it is not a vector design file.
  • Manual ReviewYou review accessibility, real content, brand fit and interaction correctness in the preview. Any self-check the agent performs is a first pass, not a sign-off.
  • FallbackWhen the agent is unavailable or a task fails, consult the connection instructions and authentication for your installed version. Before altering configuration, keep the error and the last artifact that worked.

FAQ

Common Questions About Kilo and OpenDesign

Does Kilo Code Actually Do Design Work?
Yes — with an aesthetic skill, a design system, and real reference images in context, Kilo Code produces production-quality, responsive UI, and a vision-capable model verifies output against references. Without that context it tends to default to a generic look, which is the gap OpenDesign fills.
Is There a Cost to Designing With Kilo Code?
Kilo Code is open-source and free to install. You bring your own provider API key (BYOK) and pay that provider directly, or use Kilo's own gateway at provider cost. OpenDesign never proxies your credentials either way.
What Makes Kilo Code Suited to Design?
It is model-agnostic and open-source, so you can drive it with whichever vision-capable model reads reference screenshots best, inspect exactly what context is sent, and keep cost and credentials under your control. Taste still comes from the design system, skill, and references you supply.
Kilo Code or Claude Code for Frontend Design?
Both are strong. Claude Code is known for specific, codebase-aware design decisions; Kilo Code's edge is being open-source and model-agnostic with BYOK, so you choose the model. Many teams use both — OpenDesign lets you switch agents without changing your design workflow.
How Does Kilo Code Connect to Figma?
Add a Figma MCP server from Kilo's MCP marketplace or MCP settings. Kilo can then pull real design context — components, variables, layout data — so the generated code matches the source instead of approximating it.
What Kilo Code Is
Kilo Code is an open-source AI coding agent built by Kilo Code, Inc. It runs as a VS Code extension, in JetBrains IDEs, and as a command-line interface — reading your repository, editing files, running commands, and planning and verifying work from natural-language tasks rather than just completing lines. Its defining trait is that it is model-agnostic: you choose which model drives it, and you bring your own provider keys.

For design work, two properties stand out. Because it is model-agnostic, you can point it at whichever strong vision-capable model best reads a reference screenshot and reasons about layout. And because it is open-source and BYOK, you can inspect exactly what context is sent and keep credentials and cost under your own control.

Agent modes: Kilo ships specialized modes — Architect for planning, Code for building, Debug for fixing, and Ask for questions — plus custom modes, so you can plan a design and then implement it in separate, focused passes.

Custom rules + MCP: It reads project-level custom rules for persistent context and supports MCP servers (with an MCP marketplace), so you can add external context like a live Figma file or design tooling.

Bring your own keys: Kilo is BYOK across many providers — Anthropic, OpenAI, Google, OpenRouter, and more — or you can use Kilo's own gateway, which exposes 500+ models at provider cost.

Credential: your own provider API key (BYOK — Anthropic, OpenAI, Google, OpenRouter, and more) or Kilo's own gateway

Vendor: Kilo Code, Inc. (open source)

License: open source
Why an Open, Model-Agnostic Agent Suits Design
Kilo Code’s design edge comes from openness and model choice — but, as with every agent, taste still has to be supplied.

Model-agnostic by design: Because you choose the model, you can drive Kilo with whichever vision-capable model reads reference screenshots best — and switch when a better one appears, without changing your workflow.

Open and inspectable: Kilo is open-source, so you can see exactly what context and prompts are sent — useful when you want the agent to reuse your real design primitives rather than invent one-off styles.

Conventions in custom rules: Project custom rules (plus an MCP server for Figma) point the agent at your tokens, components, and real specs, so it works against a brand instead of a default look.

Taste comes from three inputs you provide: a design system, a skill, and real reference images.

The lesson is the same one every agent teaches: Kilo Code does not have taste by default. It produces good design when you give it constraints — a design system, an aesthetic skill, and concrete references. OpenDesign packages exactly those inputs, which is why the two fit together (more below).
Setting Up Kilo Code for Design, From Zero
The setup sequence: install → connect a provider → add custom rules → add a skill → enable browser verification.

Encode your design rules: Put your tokens, primitives, and conventions in Kilo's custom rules and point the agent at them, so output matches a brand instead of defaulting to a generic look.

Add browser verification: Wire a Playwright or browser MCP so Kilo renders in a real browser and checks its output across breakpoints instead of only confirming the build passes.

Use the current setup section for commands and version-specific details, which may change.

# 1. Install the Kilo Code extension from the VS Code # (or JetBrains) marketplace, or install the CLI. # 2. Open your project and sign in / add a provider key cd your-project kilo # connect your provider (BYOK) or Kilo's gateway # 3. Add project context # create custom rules for this project's design conventions # 4. Wire the Figma MCP server (optional, for design handoff) # add it from the MCP marketplace / MCP settings
Historical command example from the previous guide; verify current syntax in the linked vendor documentation.
The Screenshot-to-UI Loop
The highest-leverage design loop with Kilo Code is turning a reference image into working, responsive UI and iterating until it matches — leaning on a vision-capable model to compare output back to the reference.

Start from the clearest visual references you have — and include multiple states (desktop and mobile, hover, empty, loading), not just one hero shot.

Be specific in the prompt; vague prompts produce generic UI even with a strong model.

Keep your design system and conventions in Kilo's custom rules, and tell the agent where the tokens and canonical primitives live.

Run a dev server and have Kilo render in a real browser, resizing to breakpoints to check the result.

Iterate by having Kilo compare its implementation back to the screenshots — not merely confirm it builds.

Use Architect mode to plan the build, then switch to Code mode and attach your references with concrete constraints:

Keep prompts small and focused, commit good iterations and revert bad ones (telling Kilo when you revert), so each pass builds on a clean base.

# Plan in Architect mode, then build in Code mode: > Implement this design from @reference-desktop.png and @reference-mobile.png in React + Vite + Tailwind + TypeScript. Reuse my existing design-system components and tokens from the custom rules. Match spacing, layout, and hierarchy; make it responsive. Render it in the browser and iterate until it matches the references across breakpoints.
Historical command example from the previous guide; verify current syntax in the linked vendor documentation.
Modes, custom rules, and MCP
Three extension points make Kilo Code practical for sustained design work, and all three map cleanly onto an open design workflow.

Modes (Architect → Code): Plan the structure of a screen in Architect mode, then implement it in Code mode and fix issues in Debug mode — separating design intent from implementation. Custom modes let you encode a design-review pass of your own.

Custom rules: Project custom rules are the durable home for your design conventions — tokens, primitives, and review checklists — read on every run so the agent works against your brand.

MCP servers: Kilo supports MCP servers via its marketplace — the portable way to bring in design context and external tools, most relevantly a Figma MCP server, that work across agents, not just Kilo.

These are portable, multi-agent capabilities — exactly the kind of thing OpenDesign is built to orchestrate, rather than re-create per project.
Kilo Code Against Codex, Claude Code, Cursor and Gemini CLI for Design
There is no single winner for design work — each agent has a different strength, and experienced teams stack them. A fair summary:

Kilo Code — Open-source and model-agnostic with BYOK across many providers; Architect/Code modes and MCP — Choosing your own model per task and keeping cost and credentials under your control

Codex — Strong visual polish with a frontend skill; sandboxed async builds — Delegated async builds and portable AGENTS.md rules

Claude Code — Specific design decisions (hex, spacing, type) and codebase-aware UX — Frontend reasoning and large-context refactors

Cursor — Visual build-and-see loop with live preview and inline edits — Tight iterate-and-watch UI work inside an IDE

Gemini CLI — Strong multimodal image understanding and a 1M-token context — Screenshot-heavy work and holding a whole design system in context

The recurring community verdict is that taste comes from humans: all of them default to a generic aesthetic without skills, references, and constraints. That is the real problem to solve — and it is design-tool-shaped, not model-shaped.

Agent — Design strength — Best for
Pitfalls, and Escaping the “AI slop” Look
The most common complaint about AI-generated design is that it looks generic — soft gradients, floating panels, oversized rounded corners, dramatic shadows, an Inter-and-purple vibe that “screams an AI made this.” Other reported issues include broken mobile layouts and instructions leaking into UI copy. None of these are unique to Kilo Code; they are what happens when any agent runs without a curated design context.

Add an aesthetic skill: A curated design skill forces the agent to commit to a real direction instead of the default look.

Verify in a real browser: Use a vision-capable model to render and self-check across breakpoints so layouts do not silently break on mobile.

Supply tokens and references: Real design tokens and reference screenshots are the single biggest lever on output quality.

Encode rules in custom rules: Put “no hero cards, max two typefaces, brand-first hierarchy” style rules where the agent reads them every run.

Notice that every mitigation is about giving the agent a curated design context. Maintaining that context by hand, per project, is the toil OpenDesign removes.
Designing With Kilo Code in OpenDesign
OpenDesign is the open-source design layer the workflow above keeps asking for. It treats Kilo Code as a first-party adapter and wraps it in a curated skill and design-system library, a structured render pipeline, and a local desktop UI — so the design context that makes Kilo good is there from the first run, not assembled by hand each time. Both are open-source and local-first, which makes the pairing a natural fit.

Authenticate with your own provider key (BYOK) or Kilo's gateway — credentials stay on your machine and are never proxied through us.

Pick a design system and a skill, then generate decks, prototypes, and landing pages with consistent taste.

Every artifact and DESIGN.md file lives in your own repo, not a hosted cloud.

Same Kilo Code agent, same keys — plus a real, portable, open-source design workflow around it. It is local-first and open-source, so nothing about your work or your credentials leaves your machine.

Install OpenDesign and select Kilo Code as your agent.
Is OpenDesign affiliated with Kilo Code?
No. OpenDesign is an independent project; both are open-source, but they are separate.