Documentation

Web Workspace

Use the web app when people need to see the media, compare actual results, make the selection, organize the Space, or collaborate. The CLI and MCP operate on the same state; changes appear across all three interfaces.

Review a Space

Open a Space to see its Assets on the full-screen canvas. Search by Asset name, open an Asset to compare its Variants, and open Variant details to inspect its prompt, Recipe, References, Lineage, status, and media facts.

The main Variant represents the Asset on the Space canvas. From a completed non-main Variant, choose More → Use as main variant to change that selection explicitly.

Regenerate or Retry

Use Regenerate… on a completed Variant when you want a different result. Forge opens with the stored Recipe and accepts meaningful model, prompt, reference, or media settings. The successful sibling becomes main only if nobody selected another Variant while it was running.

A failed Variant remains visible. Use Retry when the same Recipe should run again unchanged. If the creative instruction or settings should change, start Regenerate from a completed Variant instead.

Organize the Space

Open Organize Space to create, rename, reorder, or delete Collections and to add, remove, or reorder Assets. Collection changes do not alter media, Recipes, References, or Lineage. An Asset may belong to more than one Collection.

Copy, update, and delete

Use Forge's Copy asset destination to create a new Asset from selected media without generation. Renaming an Asset changes its mutable metadata without creating a Variant. Asset and Variant actions can also copy their stable public references for use in the CLI, MCP, or another collaborator's message.

Asset and Variant actions expose permanent deletion for eligible objects.

There is no trash:

  • activate another completed Variant before deleting the current main Variant;
  • delete the Asset to remove its only Variant;
  • deleting a Collection keeps the Assets it organized;
  • deleting a Space removes the complete Space and its stored media.

Destructive actions require confirmation and current permission.

Choose another interface

Use the CLI for terminal automation and local file transfer. Use MCP for structured agent operations. See Core Concepts for the shared product model.