跳到正文
GitHub·· 1 小时前AI 评分62

Onlook 开源设计工具发布桌面版,用自带 Agent 在真实仓库上做设计

onlook-dev/onlook

AI 导读

Onlook 发布桌面版开源设计工具,在无限画布上运行本地 Git 仓库的真实应用,由用户接入的 Claude Code 或 ChatGPT/Codex 账号直接修改仓库文件。

正文

Craft websites, prototypes, and designs with AI on a canvas built for creative work. See your real app running live, shape it visually, and let your own agent write the code. An open-source alternative to Figma, V0, Replit Agent, Base 44, Webflow, etc.

Why Onlook

  • 🎨 Built for design. Onlook is the open-source developer tool for designers. You see your real app running live on a canvas, explore ideas side by side, and shape the interface visually instead of from a terminal. Design apps, websites, posters, graphics, and more with your local fonts and assets.
  • 🤖 Bring your own agent. We don't ship our own model. Connect the Claude Code or ChatGPT/Codex account you already have, and that agent does the work inside your project. Plug in more tools through MCP connectors to bring all of the context you need to your creative workflow. Work on multiple design tasks at once across repos and pages.
  • 📁 Works on your real repo. Onlook opens any Git repository on your machine and runs your own dev server, so what you design is your actual product, not a mockup that someone has to rebuild later.
  • 🖥️ A desktop app, local-first. Onlook runs on your computer. Your code stays on your computer, and the source build needs no Onlook account, cloud keys, or .env file.
  • 📤 Share what you make. Export artifacts as self-contained HTML, PNG, JPEG, or PDF to hand off, review, or post.
  • 🧡 Open source. Apache 2.0. Read it, fork it, and customize it yourself (we'd love to hear how you customize it!)

What you can do with Onlook

  • Design on your real codebase
    • Live app on an infinite canvas
    • Mobile, tablet, and desktop frames side by side
    • Safe worktree copy, so your folder is never touched
    • Parallel projects as tabs
  • Design with your own agent
    • Bring your own Claude Code or ChatGPT/Codex plan
    • Ask about any element on the canvas
    • Agent arranges the canvas for you (variations, states, flows)
    • Reference images on the canvas
  • Sketch and share
    • Artifacts for quick HTML sketches outside your repo
    • Export to HTML, PDF, PNG, and JPEG
  • Ship it
    • Import a GitHub repo
    • Start entirely new codebases from scratch
    • One-press pull requests, from checks to merge

Getting Started

🖥️ Download the Desktop App (Recommended) – The fastest way to get started with Onlook.

  • macOS (Apple Silicon · Intel x64) → Download
  • Windows – Coming soon. Join the Windows waitlist here and be emailed when we have updates.
  • Linux – No Linux artifact is published and we're still gauging demand for Linux. Join the Linux waitlist here and be emailed when we have updates.

🧑‍💻 Build from source – SOURCE_BUILD.md covers building and running Onlook on a Mac. No Onlook account or cloud keys needed.

How it works

  1. Open a project. Point Onlook at any Git repository on your computer, or import one. Your code stays where it is.
  2. Onlook runs your app. It starts your own dev server locally, the same way you would from a terminal.
  3. See it live on a canvas. Your running app appears in frames on an open canvas, so you can look at pages, sizes, and ideas side by side.
  4. Design with your agent. Describe what you want in chat. Onlook hands the request to the Claude Code or ChatGPT/Codex account you connected, and that agent edits the real files in your repo.
  5. Watch it update. Changes show up on the canvas as your dev server reloads, and Git keeps track of everything that changed.
  6. Share the result. Export artifacts as self-contained HTML, PNG, JPEG, or PDF.

Because Onlook runs your project with its own tooling, it works with all web frameworks or languages your dev server already supports.

An example workflow

  1. Start a new empty project by clicking the "New Draft" button in the upper left corner of the projects page.
  2. Use the input box in the lower right corner of the screen to write what you'd like to be designed in Onlook.
  3. Answer clarifying questions from the agent, and wait for it to build
  4. Click to select individual frames for context in follow-up prompts, or double-click on a specific element to use the inline chat and guide the AI to edit that specific element.
  5. Prompt more ideas on one or multiple designs until you're ready to share your work with a colleague.
  6. Select the frame you'd like to share, and ask the agent to convert it into an Artifact for exporting.
  7. Export the artifact as HTML/CSS or as a PNG using the export button in the upper right corner of the frame.
  8. Paste the exported artifact in Slack, email, or any messaging tool.

Our Tech Stack

Layer Stack
Desktop Electron · React 19 · Astryx (Design system)· React Flow · Zustand · CodeMirror
Your project Git for working directly on your repo · node-pty for running your dev server and shells
Tooling Bun · Turborepo · usage analytics (see Usage data)
Export HTML · PNG & JPEG (Electron capturePage) · PDF (Electron printToPDF) & pdf-lib

Contributing

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also browse open issues.

See the CONTRIBUTING.md for instructions and code of conduct.

To report a security issue, follow SECURITY.md instead of opening a public issue.

Contributors

Contact

Looking for the previous version of Onlook?

  • Onlook v1 (web): the browser-based version lives on the v1 branch of this repository.
  • Onlook Desktop (Electron, original): the first desktop version is at onlook-dev/desktop.

Usage data

Onlook collects product usage analytics to help us improve the app. In the official download they are on by default; a build from source asks first. You can turn them off in Settings, or set STUDIO_TELEMETRY=0 to run or build without them. See the privacy policy for details.

License

Onlook's source code is distributed under the Apache 2.0 License. See LICENSE for details.

The license covers source code, not every asset in this repository. Onlook's icons come from Central Icons by Iconists. They are licensed to Onlook for its own product, and that license does not extend to forks. Onlook's brand marks, DMG art, and sounds aren't covered either. See ASSETS.md for what's covered and what to replace if you fork, and NOTICE for third-party notices.

来源:GitHub · github.com