Artifacts

An artifact is something SupaNet saves for you so you can keep it, edit it, and share it. It might be a written document, a piece of code, or a small web page like a diagram or a one-pager.

Why artifacts are useful

Normally when an assistant writes something good, it is trapped in the chat. In SupaNet you can pull it out into an artifact. Once it is an artifact you can:

Edit it in a dedicated editor. Changes are saved automatically after 2 seconds of inactivity. You can also press Cmd+S (Mac) or Ctrl+S (Windows/Linux) to save immediately.
Preview it (for web pages, you see the rendered result).
Copy the content with one click so you can use it elsewhere.
Share it by setting its visibility and copying a link.
Come back to it later - it is saved, not lost in chat history.

Two ways an artifact appears

The assistant makes one for you. When it produces something worth keeping, it saves it as an artifact and drops a share link right into the chat.
You make one yourself. On the Artifacts page you can create one from scratch and edit it.

On the Artifacts page, you can search across your entire collection by title or content. The search box finds matches anywhere in the database - not just in the visible grid - so you can locate an artifact even if it's many months old. As you type, results appear in real time.

Each artifact has a visibility setting:

Private - only you can see it.
Workspace - all team members can see and edit it.
Unlisted - anyone with the link can see it (not listed publicly).
Public - openly viewable and discoverable.

Workspace artifacts are shared internally with your team. Unlisted and Public artifacts get a shareable link that works for people outside SupaNet, even if they are not signed in.

Optional password protection

When you share an artifact (unlisted or public), you can require viewers to enter a password before they can see it. This is useful for handing someone a link plus a password — like sharing a document with a customer or partner.

To set a password, open the artifact editor, go to the Sharing panel, and click Add password (or Change if one is already set). The password is stored securely with bcrypt hashing — viewers enter it once when they follow the link, and the artifact loads only if they get it right. Incorrect passwords are indistinguishable from a broken link, so there's no way to guess or brute-force it.

You can remove the password anytime, making the artifact accessible by link alone again.

Interactive HTML artifacts

HTML artifacts can be more than static pages. The assistant can create live, interactive trackers — checklists, kanban boards, scorecards, status dashboards — that you can click to update in real time.

When you toggle a checkbox, click a status pill, or edit a note in a tracker, the change is saved immediately. That state persists across reloads and syncs to your other devices, so a tracker you start on your laptop picks up where you left off on your phone.

The assistant can also edit a tracker in place instead of making a duplicate. Ask it to "add more items" or "change the layout" and it updates the existing artifact while keeping your saved state (your checked boxes, notes, choices) intact.

Images in artifacts

When you're editing an artifact, you can paste, drag-drop, or attach an image into the body. The image is uploaded to private storage and a markdown ![](url) link is inserted at your cursor. This works like GitHub-style image embedding.

Image privacy follows artifact visibility. When your artifact is private, images are private—only you can see them. When you share an artifact (unlisted or public), its images become visible to viewers. The storage is private by default, and images are accessed via temporary signed URLs (valid for 7 days) when the artifact is private, or via public URLs when the artifact is shared.

The images are stored with a location-based path (your id + a unique identifier) so they cannot be guessed; the security model is the same as artifact slugs.

To embed an image:

Paste: Copy an image from your clipboard and paste it into the editor.
Drag and drop: Drag an image file from your desktop onto the editor.
Attach: Click the 📎 Image button in the toolbar and select file(s) to upload.

Non-image files are ignored if you paste or drop them by accident.

Linking to files

When editing an artifact, type /LinkFile (or just / to trigger the command) to insert a link to one of your files. A picker appears showing your recent files, searchable by name or title. Select one to insert it as a markdown link using the file's title (or filename if no title is set), with a 7-day signed URL so viewers can download it.

This is useful for referencing supporting documents, data files, or attachments within an artifact — like linking to a CSV from a report or a source file from a code sample.

Keyboard controls in the file picker:

↑↓ to navigate
Enter to select
Esc to cancel

Pasting URLs

When editing an artifact, if you paste a URL, it automatically converts to a markdown link with the URL as both the link text and destination. This is useful for quickly adding references or citations into your artifact.

For example, if you paste https://example.com, it becomes [https://example.com](https://example.com) and you can then edit the link text if you prefer something more descriptive.

Standalone web pages

If an artifact is an HTML page, SupaNet can serve it as a clean, full-screen page with none of the app's chrome around it - just your content at its own link. This is perfect for sharing "a great diagram in HTML" or a simple landing page without deploying a whole website.

The page is served from your artifact and rendered in a secure sandbox. Editing the artifact updates the live page - fix a typo in the editor and the public link reflects it immediately. Private artifacts are never exposed this way - only unlisted or public ones.

For interactive trackers shared publicly, the live page shows your saved state (your checked items, notes, and choices) but visitors can only view it — they cannot make changes that stick.

Pinning to Home

You can pin your most important artifacts to your Home dashboard for quick access. When you pin an artifact, it appears in the "Pinned artifacts" section of the Home Overview tab, sorted by most recently updated.

To pin or unpin an artifact:

From the Artifacts page: hover over an artifact card and click the pin icon.
From the artifact editor: click the pin icon in the toolbar.

Pinned artifacts sync live across your devices, so if you pin something on your desktop, it appears on your phone right away.

Filtering by visibility

On the Artifacts page, you can filter artifacts by their visibility status using the Visibility filter bar. Click any of the buttons—Private, Workspace, Unlisted, or Public—to show only artifacts with that visibility. The count next to each button shows how many artifacts fall into that category.

To view all artifacts again, click the Clear button or click the active filter button a second time. Your filter choice is saved in the URL, so the back button takes you back to the same filtered view.

Collections

You can group artifacts into collections - named groups you can use as a focused chat context. See Collections for the full guide.

Managing collection membership

You can add or remove an artifact from collections in two ways:

From the artifact editor: When you have an artifact open, the right panel includes a Collections section. You can see which collections the artifact is already in, add it to new collections, or remove it from existing ones without leaving the editor. You can also create a new collection directly from this panel.

From the Artifacts page: Multi-select artifacts and use the Add to collection bar to file them into one or more collections at once.

Filtering by collection

When you click a collection to filter the grid, that filter is saved in the URL. This means you can use the browser's back button to return to the collection you were viewing, and you can share a filtered view by copying the URL with ?collection= in it.

Download as markdown

When you have one or more artifacts selected on the Artifacts page, you can Download as MD to save them as a single markdown file. The downloaded file includes each artifact's title, type, visibility, last-updated date, and full content. Multiple artifacts are separated by a horizontal divider so they are easy to distinguish. This is useful for bulk-exporting artifacts to process elsewhere, back them up, or work on them in another editor.

Archiving and deleting artifacts

When you delete an artifact (either one at a time or in bulk), it moves to Trash rather than being permanently removed. This is a soft delete — the artifact is hidden from your main grid, search results, and share links, but you can still recover it later.

To archive an artifact:

From the artifact editor - click the trash icon in the toolbar. You'll see a confirmation that the artifact is moving to Trash.
From the Artifacts page - select one or more artifacts and click Archive, or right-click and choose archive.

To recover or permanently delete:

Click the Trash button on the Artifacts page (visible only when you have archived artifacts) to open your recovery area. There you can:

Restore - move the artifact back out of Trash so it's visible again.
Delete forever - permanently remove the artifact. This cannot be undone.

You can delete multiple artifacts at once, and they all move to Trash together. This gives you a safety net — you can clean up without fear of losing something you might need later.

Chat about an artifact

When you have an artifact open in the editor, a Chat button lets you talk to the assistant about it directly. Clicking it opens a conversation with the artifact pinned in a live panel beside the chat — so you can say "make it wider", "add a new row", or "change the colors" and the assistant updates it in place instead of creating a duplicate.

On desktop, hover over the panel's left edge to reveal a visual handle indicator (three dots), then drag to resize it to your preference.

Copying the artifact ID

The artifact editor includes a Copy ID button in the toolbar. Click it to copy the artifact's unique identifier, which you can use with MCP tools and external Claude integrations. This ID is stable and works across APIs and integrations — useful for referencing the artifact when working with external systems.

A nice side effect

Because artifacts live in the workspace, the assistant can also create and update them on your behalf as part of a larger task. Ask it to "write this up and share it" and you get back a link, not a wall of text to copy.