Artifacts and Live Previews
Inspect generated files, rendered HTML, documents, images, media outputs, and live artifacts safely inside the desktop app.
Artifacts are files and rich outputs produced during an agent task. They can include documents, HTML previews, images, videos, code files, data files, and generated media. The desktop app keeps these outputs close to the task thread so you can inspect, revise, export, or publish them.
Where Artifacts Appear
Artifacts can appear in several places:
- A task message bubble
- The task file panel
- DesignMode project files
- Generated media previews
- Local output previews
- Publish source pickers
When the app recognizes an output type, it shows an appropriate preview instead of forcing you to open the raw file.
Live HTML Artifacts
Live HTML artifacts render in a sandboxed preview. This lets you inspect generated dashboards, prototypes, landing pages, or small apps without giving the artifact unrestricted access to the desktop app.
Use live previews for:
- HTML prototypes
- Interactive dashboards
- Generated reports with charts
- Small web tools
- DesignMode live artifacts
If the artifact depends on external data, verify the source and refresh policy before publishing or sharing it.
Document and Media Previews
The app can classify and preview common output types:
| Output Type | Preview Behavior |
|---|---|
| Images | Inline image preview and media actions |
| Videos | Video preview with generated media context |
| PDFs | Document preview or file viewer |
| DOCX/PPTX | Extracted document preview when supported |
| Markdown | Rendered markdown preview |
| Code or data files | Syntax-aware file viewer when available |
If a file cannot be previewed, open it from the workspace path or export it through the task file controls.
Safe Rendering
Artifact previews use isolation controls so generated content cannot freely access your app state.
Best practices:
- Preview generated HTML before sharing it
- Avoid entering secrets into generated artifacts
- Treat unfamiliar external scripts as untrusted
- Export or publish only after reviewing visible content and metadata
- Use workspace permissions to limit what the generating agent can write
Revise an Artifact
- Open the task or DesignMode project that produced the artifact
- Inspect the preview
- Ask the agent for a targeted revision
- Compare the new output with the previous version
- Export or publish the approved version
For DesignMode projects, use file tabs, the quick file switcher, comments, and the inspect panel to move between source files and rendered output.
Publish an Artifact
When publishing is enabled, supported artifacts can be sent to a publish destination.
- Open the artifact preview
- Click the publish action
- Choose destinations
- Add metadata
- Review approvals if required
Publish from the reviewed artifact, not from an intermediate file you have not inspected.