# Artifact Vault

The Artifact Vault is a centralized workspace for all of your **saved and shared** artifacts in DarcyIQ. Browse, search, organize, and take action on every artifact your team has created — all from a single, persistent page.

{% hint style="success" %}
**Your Artifact Home Base**: The Vault gives every artifact a permanent home — browse, organize, and share anything you've created from a single page.
{% endhint %}

## Overview

| Feature                 | Capability                                                        | Business Impact                              |
| ----------------------- | ----------------------------------------------------------------- | -------------------------------------------- |
| **Centralized Library** | All artifacts in one browsable workspace                          | No more hunting through conversations        |
| **Folder Organization** | Create folders and nest artifacts into a tree structure           | Keep projects tidy and navigable             |
| **Search & Filter**     | Full-text search with type, project, date, and visibility filters | Find any artifact instantly                  |
| **Bulk Actions**        | Checkbox selection with move and delete operations                | Manage artifacts at scale                    |
| **Inline Editing**      | Edit artifact content directly in the Vault                       | Quick updates without leaving the page       |
| **Public Sharing**      | Publish artifacts with optional password protection and expiry    | Share work with stakeholders securely        |
| **Project Assignment**  | Assign artifacts to one or more projects                          | Keep artifacts tied to the work they support |

## Navigating the Vault

The Vault uses a two-panel layout: a collapsible **file tree** on the left and a **content viewer** on the right. The file tree displays your artifacts organized into folders, while the content viewer renders the selected artifact for reading or editing.

### File Tree

The file tree is the primary way to browse your artifacts.

| Action                         | How                                                      |
| ------------------------------ | -------------------------------------------------------- |
| **Open an artifact**           | Click any file in the tree                               |
| **Expand / collapse a folder** | Click the folder row or the chevron                      |
| **Create a file or folder**    | Use the **+** button at the top of the tree              |
| **Rename**                     | Right-click a file or folder and choose **Rename**       |
| **Move**                       | Right-click and choose **Move to…**, or use bulk actions |
| **Delete**                     | Right-click and choose **Delete**                        |
| **Sort**                       | Toggle between **Recent** and **A–Z** ordering           |
| **Collapse sidebar**           | Click the sidebar toggle to maximize the content area    |

### Search

Type into the search bar at the top of the file tree to filter artifacts by name. Results update as you type, making it easy to locate a specific artifact across your entire Vault.

## Filtering Artifacts

Use the filter controls to narrow down what's visible in the Vault.

| Filter          | Options                                          | Description                                     |
| --------------- | ------------------------------------------------ | ----------------------------------------------- |
| **Type**        | Markdown, React, Python, Mermaid, HTML, Code Run | Show only artifacts of a specific type          |
| **Project**     | Any project in your workspace                    | Show artifacts assigned to a particular project |
| **Date Range**  | Custom start and end dates                       | Show artifacts created within a window          |
| **Public Only** | Toggle                                           | Show only published artifacts                   |
| **Apps Only**   | Toggle                                           | Show only interactive app artifacts             |

Active filters appear as dismissible chips, so you always know what's applied.

## Bulk Actions

Select multiple artifacts using checkboxes to act on them in batch.

{% stepper %}
{% step %}
**Select Artifacts** Click the checkbox on each artifact you want to include. Hold **Shift** and click to select a range.
{% endstep %}

{% step %}
**Choose an Action** The toolbar updates to show available bulk actions — **Move** or **Delete**.
{% endstep %}

{% step %}
**Confirm** Move the selected artifacts into a target folder, or confirm deletion. Changes apply immediately.
{% endstep %}
{% endstepper %}

## Editing Artifacts

Click any artifact in the Vault to open it in the content viewer. Depending on the artifact type you'll see either:

* **Note editor** — for plain-text and markdown notes, with inline editing
* **Artifact viewer** — for rich artifacts like React apps, diagrams, code runs, and presentations

Changes made in the editor are saved back to the artifact directly.

## Sharing & Publishing

Artifacts can be published to generate a public URL that anyone can access — no DarcyIQ account required.

| Option                  | Description                                                  |
| ----------------------- | ------------------------------------------------------------ |
| **Publish**             | Toggle an artifact to published and receive a shareable link |
| **Password Protection** | Optionally require a password to view the published artifact |
| **Expiry**              | Set an expiration date after which the link stops working    |
| **Unpublish**           | Revoke public access at any time                             |

Published artifacts display a globe icon in the file tree so you can see at a glance which items are shared.

## Darcy Chat Integration

Open **Darcy Chat** directly from the Vault to ask questions about your artifacts, generate new content, or refine existing work without leaving the page.

## Getting Started

1. Navigate to **Artifact Vault** from the main navigation
2. Your existing artifacts are automatically available in the Vault
3. Create folders to organize artifacts by client, project, or topic
4. Use search and filters to quickly locate what you need
5. Select artifacts in bulk to move or clean up in batch

{% hint style="info" %}
**Pro Tip**: Combine folder organization with project assignment for maximum flexibility. Folders give you a visual hierarchy in the Vault, while project assignment links artifacts to the broader project context across DarcyIQ.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.darcyiq.com/core-features/artifact-vault.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.