Skip to content
Tools/Workspace & Portfolios/switch_product

switch_product

Switch to a different .upg file without restarting the server. In workspace mode, accepts just a filename (e.g. "client-project" or "client-project.upg").

Workspace & Portfoliosnon-atomic. Flushes the current store, stops watching, and loads the new file as separate filesystem operations.

Arguments

filestringrequired

Path to the .upg file (relative, absolute, or a bare product name in workspace mode).

Returns

Shape
{ message, file, product: { title, stage }, entities }

Warnings

Mutates server-side workspace state. After an MCP reconnect the server reverts to the workspace default. Call `get_workspace_info` before any read/mutation to confirm the active product.

See Also