Lookingglass: point at the bug, your agent fixes it

๐Ÿ”ญ Lookingglass

Point at the bug. Your agent fixes it.
A desktop editor where your app, your code and your coding agent live in one window.

Download ยท Install ยท Set up ยท Use ยท Design notes

Coding agents are great at code and blind to the UI. Lookingglass gives them eyes. Run your dev server, open it in the built-in browser, click the button that looks wrong and ask. The agent gets the element's HTML, styles, a screenshot and the **source file that rendered it**. It edits the code, HMR reloads, it takes its own screenshot to check, and you review the result hunk by hunk. ## โœจ Why you'll like it - ๐ŸŽฏ **Point, don't describe.** Pick an element and the agent sees what you see: markup, matched CSS rules, computed styles, accessibility info and a screenshot. - ๐Ÿ“ **From pixel to file.** `src/components/Hero.tsx:42`, found through React, Vue and Svelte dev metadata, source maps and search. - ๐Ÿค– **The agent checks its own work.** It can click, type, resize to a phone viewport, read the console and screenshot, so "fix it and verify" is one turn. - ๐Ÿ”‘ **Bring your own agent.** No new account, no proxied keys. Claude Code works out of the box; Codex, Gemini CLI or any [ACP](https://agentclientprotocol.com) agent plug in with a few lines of JSON. - ๐Ÿง **Review before you keep.** Keep or undo every hunk. Every message takes a checkpoint, so one click rolls everything back, even outside git. - โ†—๏ธ **Hand off to your own editor.** One click opens the file at the right line in VS Code, Cursor, Windsurf or a JetBrains IDE. - ๐Ÿ› ๏ธ **A real editor around it.** File tree, search, git, diagnostics and a terminal. You can work without the agent too. ## ๐Ÿš€ Quick start 1. **Download** the installer for your OS from [Releases](https://github.com/NietThijmen/looking-glass/releases) (macOS `.dmg`, Windows installer, Linux AppImage). 2. **Log in** to Claude Code: run `claude` once in a terminal, or set `ANTHROPIC_API_KEY`. 3. **Open your project** with `โŒ˜O`, start your dev server in the terminal (`` โŒƒ` ``) and open the URL it prints. 4. **Pick an element** with `โŒ˜โ‡งC`, type your question, press `Enter`. Details: [Installation](docs/installation.md) ยท [Setup](docs/setup.md) ยท [Usage guide](docs/usage.md) ## ๐ŸŽฌ See it in action **Pick an element and ask.** The agent gets the markup, styles, a screenshot and the source file. ![Picking the "Get started" button and asking about it](docs/images/element-picker.png) **Review what the agent changed**, hunk by hunk, and keep or undo it. ![The agent's CSS edit shown as a diff](docs/images/review-changes.png) **Check it at any size**, with device presets and a console that can feed straight into chat. ![The page in the phone preset](docs/images/device-preset.png) ## ๐Ÿ“š Documentation | Guide | What's in it | | ------------------------------------ | ------------------------------------------------------------------------ | | [Installation](docs/installation.md) | Installers, first launch, building from source, updates, troubleshooting | | [Setup](docs/setup.md) | Agents, per-project settings, MCP servers, shortcuts, source mapping | | [Usage](docs/usage.md) | The picker, chat, @-mentions, reviewing edits, the editor, the terminal | | [Design notes](docs/design.md) | Architecture, ACP integration, security model, roadmap | ## ๐Ÿ”’ Privacy and safety - Agents run as separate processes, and every file path they use is confined to the open folder. - Picked elements, screenshots and console output go to the agent you're chatting with, and so to its model provider. Check the chip before sending. - The built-in browser has its own profile. Agents can browse `localhost` freely; going elsewhere or running JavaScript in the page asks you first. - Lookingglass stores no credentials. Logins stay in each agent's own config. ## ๐Ÿง‘โ€๐Ÿ’ป Development Requires Node 24+ and pnpm 11. ```bash pnpm install pnpm dev # run the app with hot reload pnpm check # typecheck + lint + prettier + unit tests pnpm smoke # build and drive the real app against a throwaway repo pnpm package # installers for your platform ``` Built with Electron, React and TypeScript. See [docs/installation.md](docs/installation.md#build-from-source) for more. ## ๐Ÿ”— Links [Agent Client Protocol](https://agentclientprotocol.com) ยท [ACP adapters and SDKs](https://github.com/agentclientprotocol) ยท [Model Context Protocol](https://modelcontextprotocol.io)