Use TypeUI with Hermes

Follow this guide to connect Hermes Agent to TypeUI while it edits UI in your project.

Open Hermes

Open a terminal in the project where you want Hermes Agent to build or improve UI.

Add TypeUI to Hermes

Create or update ~/.hermes/config.yaml with a TypeUI MCP server entry:

Plain text
mcp_servers:
  typeui:
    url: "https://mcp.typeui.sh"
    auth: oauth

Start Hermes:

Run in terminal
hermes chat

When Hermes starts the OAuth flow, sign in with TypeUI and authorize the connection.

If Hermes is already running after you edit the config, reload MCP servers from the chat:

Plain text
/reload-mcp

You can also start the TypeUI OAuth flow from a fresh terminal:

Run in terminal
hermes mcp login typeui

Create a draft

Start from a theme, a markdown ZIP, or a Figma import. TypeUI creates an editable draft design system in your workspace.

Review the markdown

Open View markdown source files and review them before publishing.

Files to review

The main entry file. It tells AI tools how to use this design system and where to look next.Logo and brand asset guidance. Colors, typography, and spacing stay in their own files.Color tokens and usage guidance for brand, surfaces, text, borders, and states.Font families, sizes, weights, line heights, headings, labels, and body text rules.Spacing, grids, containers, responsive behavior, and layout structure rules.Button sizes, variants, states, icon spacing, focus behavior, and accessibility rules.+14 more

Edit the source files

Adjust the markdown when you need clearer rules, stronger component guidance, or product-specific language. After publishing, TypeUI MCP uses your saved edits when it helps your AI tool build UI.

Publish for MCP

Publish when ready so your MCP-connected AI tool can use it.

Start building UI

Use TypeUI to help me build a landing page.

Tell Hermes what to build. TypeUI helps it choose the right style and layout.

Review and refine

Run your app and review the changes. Ask Hermes for targeted improvements:

I don't like this pricing section, give me more variations.

TypeUI will now create three pricing variations so you can compare different layouts before choosing one.

Three pricing cards prompt preview
TypeUITypeUI

After you choose a direction, tell Hermes which one to use:

I like the comparison one. Let's use it.

Once Hermes is connected to TypeUI, you can keep working in the same flow: choose a design system, ask for the interface you need, review the generated variations, and tell Hermes which direction to continue with.