Documentation

Start your first session

Install once, open your project, and connect your agent.

Install the reusable Foundry skill and shared MCP connection once. The skill teaches your agent how to operate Foundry; the connection lets it receive your reviewed changes.

Install once
npx foundry-design install

Restart your agent, then open a project.

Restart your selected coding agent once so it loads the shared connection. Open the project you want to refine and ask your agent:

Agent prompt
Start Foundry for this project and keep listening for Apply with agent requests.

The agent starts Foundry from the project, adds or updates its supported development adapter, validates the integration, and opens the visual session. Keep the agent listening while you work.

Make one change, then review it.

Select an element on the canvas or in Layers. Change a value in the Inspector, then open Review to inspect the original and requested values. These are temporary visual edits until you approve the batch and choose Apply with agent.

Starting from a terminal instead?

Open from your project
npx foundry-design

Foundry reuses an available development server and local runtime when possible, resumes the most recent session for the current source revision, and opens a per-session authenticated preview.