Cosmo Docs
Hub

Artifacts & Trash

How to create, rename, delete, restore, and permanently remove artifacts in Cosmo.

Artifacts

Artifacts are documents, reports, proposals, and other outputs that Cosmo generates or that you create in a workspace. Each artifact is stored in your workspace (in the cloud when you're signed in) and can be opened from the Hub canvas.

Inline rename

To rename an artifact, hover over its row in the workspace list, click the pencil icon, type the new name, and press Enter. Press Escape to cancel without saving.

Finding artifacts: sorting and views

The toolbar above a workspace's artifact list has a search box, a sort dropdown, and a list/grid view toggle.

  • Search matches against artifact title only — it does not search artifact content. Matching is case-insensitive and ignores leading/trailing whitespace.
  • Sort has three modes: Last updated (most recently updated first — the default), Name A→Z, and Created (most recently created first).
  • View switches between a compact list and a grid of cards; both show the same set of artifacts in the same order.

The search box clears automatically whenever you switch to a different workspace — it does not carry over between workspaces. Sort mode and view stay as you left them.

Downloading an artifact

Click the download icon on an artifact row, its grid card, or in the artifact viewer header to save it locally. Generated documents (the AI-authored HTML you see in the artifact viewer) download as a PDF, preserving text, layout, tables, images, and charts. Uploaded files you didn't generate — images, PDFs, spreadsheets, Office documents, plain text — download unchanged, in their original format.

Deleting an artifact

Click the trash icon on an artifact row or in the artifact viewer header to soft-delete it. A confirmation dialog appears; confirm to move the artifact to Trash.

When deleting from a workspace list, an Undo toast appears at the bottom of the screen for 8 seconds — click Undo to restore the artifact immediately without opening Trash. When deleting from the artifact viewer, you are returned to the workspace list; use Trash to restore if needed.

Interactive artifacts remember their state

Some generated documents include interactive elements — a calculator, a form, a checklist with checkboxes to tick off. Whatever you enter or select is saved automatically as you use it (briefly debounced, so it doesn't save on every single keystroke), and is there the next time you or anyone else with access opens the artifact — reopening it later, or reloading the app, doesn't reset it back to a blank slate.

This state is shared, not personal to you: it lives on the artifact itself, so anyone who can open it sees the same saved values. A viewer with read-only access (for example, someone who only has view access to the workspace it's in) can still interact with the artifact in their own session, but their changes don't save — the next person to open it sees the last value someone with edit access saved.

Sharing

Click Share on an artifact to open the Share dialog. You can invite specific org members by name or email — each gets a notification and can open the artifact from the app — or turn on General access to share it with anyone via a link, without adding people one by one.

In the Share dialog, click Change next to "General access". There are two levels:

  • Anyone in your organization — they still need the link, and they must be signed in to a Cosmo account in your organization. Someone outside it is told they don't have access, even with the link.
  • Anyone with the link — no Cosmo account or sign-in required, including people outside your organization.

Confirm the choice, then click Copy link to copy the URL. You can switch between the two levels later from the same Change control; the link itself stays the same, so a URL you've already sent keeps working at the new level.

Widening access asks you to confirm (turning sharing on, or moving from organization-only to anyone). Narrowing it — anyone-with-the-link back to organization-only — applies straight away.

A link-shared artifact always shows the artifact's current content — there's no way yet to pin a link to a specific past version.

Only text/html artifacts (the documents, reports, and proposals Cosmo generates) can be viewed through a link today. Other file types — images, PDFs, spreadsheets, Office documents — show a "can't be previewed here" message when opened via a link; open them from the Cosmo app instead.

Turning off General access

Click Stop sharing in the Share dialog. The link stops working immediately for anyone who doesn't already have access some other way — people you invited individually by name or email are unaffected. Turning General access back on later reuses the same link URL.

Only people who can edit the workspace can turn link sharing on or off. If a workspace was shared with you as read-only, you can see whether a link exists but not change it. A personal artifact can only be link-shared by its owner.

Trash

Deleted artifacts are held in Trash for 7 days before being permanently removed. During that window you can restore them.

Opening Trash

Click Trash in the Hub sidebar (left-hand panel).

Restoring an artifact

In Trash, click the Restore button on any row. The artifact returns to its original workspace.

Permanently deleting an artifact

Click the red trash icon on a Trash row to permanently delete the artifact immediately. A confirmation dialog warns that this action cannot be undone. Artifacts that are not restored within 7 days are automatically purged.