<!-- How it works: AgentDesign -->
> Three parts: the app you look at, a small program your agent connects to, and a folder of plain files on your Mac. Set up in three steps.

Source: https://getagentdesign.com/how-it-works

# Three parts. All on your Mac.

The app you look at, a small program your agent uses, and a folder of files.

That program is an MCP server, the standard way an agent plugs into a tool.

## How the parts connect.

1. Your agentThe agent you already use.
2. MCP serverYour agent starts it.
3. A folder you choosePlain, readable files.
4. AgentDesign appWhere you look, comment and compare.

Your agent is not part of AgentDesign. AgentDesign is the server, the folder and the app.

## Connect your agent.

Install the app, then choose Connect my agents in Settings > Agents. You say yes once.

There is nothing to copy. To connect by hand instead, pick your agent below.

### Claude Code

Run this line in a terminal. Restart Claude Code, then ask it to list your AgentDesign projects.

```
claude mcp add --scope user agentdesign -- "/Applications/AgentDesign.app/Contents/MacOS/agentdesign" mcp
```

It calls project_list. If your projects come back, you are connected.

### Claude Desktop

Add this to the mcpServers section of Claude Desktop's settings file. Quit and reopen Claude Desktop.

```
{"mcpServers": {"agentdesign": {"command": "/Applications/AgentDesign.app/Contents/MacOS/agentdesign", "args": ["mcp"]}}}
```

The app shows this exact text in Settings.

### Codex

Add this to ~/.codex/config.toml, then restart Codex.

```
[mcp_servers.agentdesign]
command = "/Applications/AgentDesign.app/Contents/MacOS/agentdesign"
args = ["mcp"]
```

### Cursor

Add this to the mcpServers section of Cursor's MCP settings file, then restart Cursor.

```
{"mcpServers": {"agentdesign": {"command": "/Applications/AgentDesign.app/Contents/MacOS/agentdesign", "args": ["mcp"]}}}
```

The app shows this exact text in Settings.

### Another agent

Any agent that supports MCP and can start a program on your Mac can use this command.

```
"/Applications/AgentDesign.app/Contents/MacOS/agentdesign" mcp
```

## What your agent can do.

[Design](https://getagentdesign.com/features#design)

Design screens, components and flows, and get a picture back.

[Review](https://getagentdesign.com/features#review)

Read comments, change the design, mark them answered.

[Decisions](https://getagentdesign.com/features#decisions)

Record what the owner settles, and read the house rules before working.

[Versions](https://getagentdesign.com/features#releases)

Group screens into versions and read what changed since live.

[Real app](https://getagentdesign.com/features#real-app)

Screenshot simulators, emulators or your local web build.

[Find and share](https://getagentdesign.com/features#find)

Search, write docs, and export a project or version.

[Your files](https://getagentdesign.com/features#files)

Read and write plain files in your folder.

[Clear errors](https://getagentdesign.com/features#agent-first-day)

A wrong request is refused with what's missing.

## What you do.

Start on For you

One page shows what changed since you last looked and the comments still open.

Review

Look at the screens your agent designs.

Comment

Pin what's wrong. Your agent reads it.

Approve

Approve a design or ask for changes. Only you can approve.

Pick an option

Pick one and say why.

Pick a version

Choose which version you are looking at: live, building now or planned.

Compare

Put two versions side by side, or look back.

See what is live

Your agent marks a version live. AgentDesign records it, and its screens stay as they were. Marked live by mistake? Undo puts it back.

Resolve

Close a comment when the change is right.

## Where your files live.

A project is a folder inside the folder you choose. This is the Reader sample.

```
~/Designs/reader/
  project.json
  items/
    screens/
      home/
        item.json
        comments.json
        notes.md
        revisions/
          r0001.json
          r0002.json
  versions/
    ios-1.4.json
    ios-1.5.json
```

Each change is one numbered file. Earlier files never change. Put the folder in git.

## What it does not do.

- Nobody designs by hand. Your agent designs; you review.
- Designs are saved in AgentDesign's own format, not HTML and CSS.
- It cannot open a.fig file and never signs in to Figma or pen.dev. Version 1.1 imports no Figma or pen.dev files.
- Screenshots come from simulators, emulators and local web builds, not a phone or a live website.
- No cloud sync. To share a project, put its folder in git.
- macOS only today. Windows and Linux are planned for version 2.

Missing something you need? Tell us what, and why.

[Request a feature](mailto:hello@getagentdesign.com?subject=AgentDesign%20feature%20request&body=What%20do%20you%20want%20AgentDesign%20to%20do%3F%0D%0A%0D%0AWhat%20are%20you%20building%2C%20and%20with%20which%20agent%3F%0D%0A%0D%0AHow%20do%20you%20work%20around%20it%20today%3F%0D%0A)

## Ready to connect your agent?

[Download](https://getagentdesign.com/pricing#get)

Free for one app and two versions. Unlimited: $49, paid once.
