Vault Overview

The artifact vault is where all your saved artifacts live. This article walks the UI: list panel, search, filters, detail view, pinning, versions.

Where to find it

Click 📦 Vault in the dock (phones: the Vault tab) (chassis-specific name varies — see What is a Project? for terminology). The panel opens with the vault contents.

In Ridgeline this is References. In Atlas it's Notebook entries. In Studio it's Stems. Same data, chassis-tinted label.

Layout

The vault has two main areas:

Area	Contents
List panel (left)	All artifacts, sorted with pinned first then by recency
Detail panel (right)	Selected artifact: title, content, tags, version history, edit

When no artifact is selected the list takes the full width.

The header bar

Above the list:

Search box — text input for fuzzy search; toggle 🔍 between fuzzy and semantic mode
Type chips — filter by All / Text / Markdown / Code / JSON / List
Tag chips — top-10 most-used tags as quick filters
The ? Help button (added in Phase 3b) links here

Per-artifact display

Each artifact in the list shows:

Type icon (color-coded: text=gray, markdown=blue, code=purple, JSON=amber, list=green)
Title (auto-generated or user-set)
Pinned indicator (📌) if pinned
Time-ago (e.g. "3h ago", "2d ago")
Tag chips if tagged

Click an artifact to open it in the detail panel.

Detail panel actions

When an artifact is open:

Action	Effect
Edit	Inline editing of title and content
Pin / Unpin	Toggle pin status (pinned items appear at top of list)
Tags	Add or remove tags
Copy	Copy content to clipboard
Download	Save artifact content as a file (extension matches type)
Inject	Insert into the current chat input (depends on chassis)
Versions	View past versions, restore an old one
Delete	Permanent delete (no undo within the vault)

Versions

Every edit to an artifact creates a new version automatically. The detail panel shows a History toggle that reveals the full version chain:

Each version shows its number, when it was saved, and a preview
Click a version → preview opens in a comparison view
Click Restore to make that version the current one (creates a new version above it; the in-between is preserved)

This means the vault is non-destructive — editing never loses old content.

Pinning

Pin artifacts you want to keep at the top:

Click the pin icon in the detail panel or in the list row
Pinned artifacts always appear first, sorted by pin order
Useful for active reference material, working drafts, persistent code snippets

Counts and limits

Currently:

No hard limit on artifact count per user
No hard size limit per artifact (practical: keep individual artifacts <100KB for fast IndexedDB scans)
Embeddings computed per artifact for semantic search; takes ~50-200ms per save

Free tier vs Pro:

Both have unlimited artifacts
Pro gets larger embeddings cache (faster semantic search at high volume)

Performance

The vault uses IndexedDB which scales well to thousands of artifacts. With ~10,000 artifacts: