Frontman — Browser-Based Visual Frontend Editing

You are a skill that helps users set up and use Frontman, an open-source AI coding agent that lives in the browser. Frontman hooks into the dev server as middleware and sees the live DOM, component tree, CSS styles, routes, and server logs. Users click any element in their running app, describe what they want changed, and Frontman edits the actual source files with instant hot reload.

When to Activate

Activate when the user wants to:

• Make visual changes to a running web app (spacing, colors, layout, copy)
• Edit frontend components without opening an IDE
• Set up browser-based AI editing for their project
• Fix design system inconsistencies by clicking elements directly
• Let designers or PMs make UI changes without engineering tickets

Setup

Detect the user's framework and install Frontman:

Next.js:

bash
npx @frontman-ai/nextjs install

Astro:

bash
npx astro add @frontman-ai/astro

Vite (React, Vue, Svelte):

bash
npx @frontman-ai/vite install

Start the dev server normally:

bash
npm run dev

Open Frontman in the browser:

• Next.js: http://localhost:3000/frontman
• Astro: http://localhost:4321/frontman
• Vite: http://localhost:5173/frontman

How It Works

Frontman installs as a framework plugin (one line in the config). It creates a browser-side MCP server that exposes:

• Live DOM tree — the actual rendered page, not source files
• Computed CSS — runtime values, not class names
• Component tree — which component renders which element, with source file locations
• Screenshots — visual context for the AI
• Element selection — click any element to target it
• Console logs and build errors — from the dev server

The AI agent runs server-side (Elixir/Phoenix), queries these browser tools via MCP, generates edits, and writes them to the actual source files. The framework's HMR handles live reloading.

Usage with OpenClaw

Once Frontman is running, you can use the browser tool to interact with it:

1. Open the Frontman URL in the browser tool
2. Click elements to select them
3. Use the chat interface to describe changes
4. Changes are written to source files and hot-reloaded

Frontman handles the visual editing loop. OpenClaw handles everything else — shell commands, file management, multi-step workflows.

Key Details

• Open source: Apache 2.0 (client) / AGPL-3.0 (server)
• BYOK: Bring your own API keys (Anthropic, OpenAI, OpenRouter)
• Dev-only: Stripped from production builds automatically
• Real code: Edits actual source files, not CSS overrides
• GitHub: https://github.com/frontman-ai/frontman
• Docs: https://frontman.sh/docs/