foundry-design-web-adapter 0.2.0-beta.14 → 0.2.0-beta.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +23 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@ Foundry is a local-first precision design workbench for Codex, Cursor, and Claud
|
|
|
6
6
|
|
|
7
7
|
Foundry is distributed through npm, so testers do not need GitHub access.
|
|
8
8
|
|
|
9
|
-
> **Release candidate:** `0.2.0-beta.
|
|
9
|
+
> **Release candidate:** `0.2.0-beta.15`. The commands below are prepared for this release and must not be promoted to npm `latest` until the full installation matrix passes.
|
|
10
10
|
|
|
11
11
|
Full documentation is available at [withfoundry.ai](https://withfoundry.ai).
|
|
12
12
|
|
|
@@ -110,6 +110,25 @@ Supported automatic web integration currently includes Next.js App Router, Vite,
|
|
|
110
110
|
|
|
111
111
|
The npm setup above is the public beta installation path and includes the same portable skill and MCP connection used by the agent plugin bundle.
|
|
112
112
|
|
|
113
|
+
### Agent-native installation
|
|
114
|
+
|
|
115
|
+
The npm installer remains the universal route. Foundry also ships one versioned plugin bundle for Codex, Cursor, and Claude Code, so each host can load the same skill, MCP bridge, and session guidance through its native plugin system.
|
|
116
|
+
|
|
117
|
+
For Claude Code, add the public marketplace and install Foundry once:
|
|
118
|
+
|
|
119
|
+
```text
|
|
120
|
+
/plugin marketplace add seanx24x/foundry-design-control
|
|
121
|
+
/plugin install foundry-design-control@foundry-design-control
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
Run `/reload-plugins`, open a project, then run `npx foundry-design` once to connect its development adapter.
|
|
125
|
+
|
|
126
|
+
For Cursor, use the one-click MCP connection below while the complete plugin awaits marketplace review. The repository contains a validated Cursor plugin with the Foundry skill, command, hook, and MCP bridge for local testing and submission.
|
|
127
|
+
|
|
128
|
+
For Codex, the repository contains the Agent Plugin and Codex presentation metadata used for public marketplace submission. Until that listing is available, `npx foundry-design install-agent codex` installs the identical shared skill and bridge without requiring the repository.
|
|
129
|
+
|
|
130
|
+
See [Distribution](DISTRIBUTION.md) for the exact supported route, validation command, and update boundary for every host.
|
|
131
|
+
|
|
113
132
|
### Claude Desktop extension
|
|
114
133
|
|
|
115
134
|
The repository also produces a validated `.mcpb` extension for Claude Desktop. It bundles the local Foundry MCP bridge and can be installed through **Settings → Extensions → Advanced → Install Extension**. This provides a host-native alternative when a Claude Desktop surface does not merge the normal user-level Claude Code MCP configuration. Project instrumentation is still installed with `npx foundry-design`.
|
|
@@ -118,14 +137,14 @@ If an npm mirror or existing `npx` cache reports an old tag, bypass it with a te
|
|
|
118
137
|
|
|
119
138
|
```bash
|
|
120
139
|
FOUNDRY_NPX_CACHE="$(mktemp -d)"
|
|
121
|
-
npx --yes --prefer-online --registry=https://registry.npmjs.org --cache "$FOUNDRY_NPX_CACHE" --package=foundry-design@0.2.0-beta.
|
|
140
|
+
npx --yes --prefer-online --registry=https://registry.npmjs.org --cache "$FOUNDRY_NPX_CACHE" --package=foundry-design@0.2.0-beta.15 foundry-design
|
|
122
141
|
```
|
|
123
142
|
|
|
124
143
|
The beta supports Node.js 20 or newer. Read the [local-first safety model](https://withfoundry.ai/#safety) before using it with sensitive work.
|
|
125
144
|
|
|
126
145
|
## Agent plugin
|
|
127
146
|
|
|
128
|
-
The portable plugin lives at `plugins/foundry-design-control`. The repository also includes marketplace manifests for Codex, Cursor, and Claude-compatible plugin import. Until public marketplace review is complete, `
|
|
147
|
+
The portable plugin lives at `plugins/foundry-design-control`. The repository also includes marketplace manifests for Codex, Cursor, and Claude-compatible plugin import. Until public marketplace review is complete, `npx foundry-design install` installs the same reusable skill and MCP connection from npm without requiring source-repository access. Once installed, ask your agent:
|
|
129
148
|
|
|
130
149
|
```text
|
|
131
150
|
Start Foundry for this project.
|
|
@@ -135,7 +154,7 @@ Foundry remains local-first. Installing the plugin does not create an account, e
|
|
|
135
154
|
|
|
136
155
|
### Cursor one-click connection
|
|
137
156
|
|
|
138
|
-
[Add the Foundry MCP bridge to Cursor](
|
|
157
|
+
[Add the Foundry MCP bridge to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=foundry-design-control&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIi0tcHJlZmVyLW9ubGluZSIsImZvdW5kcnktZGVzaWduLW1jcC1zZXJ2ZXJAMC4yLjAtYmV0YS4xNSJdLCJlbnYiOnsiRk9VTkRSWV9ERVNJR05fUlVOVElNRV9VUkwiOiJodHRwOi8vMTI3LjAuMC4xOjQzODcifX0%3D), then run `npx foundry-design` inside the project. The repository's Cursor plugin additionally bundles the Foundry skill and session-start hook for marketplace distribution.
|
|
139
158
|
|
|
140
159
|
## Current capabilities
|
|
141
160
|
|