Artifacts

Artifacts are the rich content objects within a workspace — proposals, reports, analyses, documents, and more. They are created by AI through chat, rendered as interactive HTML in the Hub, and versioned automatically so your team always has the latest version.

What Are Artifacts?

An artifact is a self-contained HTML document that lives inside a workspace. Unlike chat messages that scroll by, artifacts persist as named, versioned files that you can return to, share with your team, and refine over time.

Artifacts can include:

• Formatted text — headings, tables, lists, and styled content
• Charts and visualizations — bar charts, pie charts, line graphs, and more via Chart.js
• Data tables — structured data with professional formatting
• Custom layouts — multi-column designs, cards, dashboards

Every artifact is scoped to a workspace and synced to the cloud, making it available to all members of your organization.

Creating Artifacts

Ask Cosmo in the chat to create a document, and it will generate a complete HTML artifact inside the relevant workspace.

Example prompts:

• "Write a Q3 revenue proposal with a projected growth chart"
• "Create an analysis of our customer churn data with visualizations"
• "Draft a brief for the new mobile app initiative"
• "Build a competitive landscape report with a comparison table"

Cosmo will:

1. Identify the right workspace (or ask if you'd like to create one)
2. Generate a complete, styled HTML artifact with dark-themed professional design
3. Save it to the workspace and notify you in the chat
4. The artifact appears instantly in the Hub under that workspace

Smart Workspace Placement

Before creating an artifact, Cosmo checks your existing workspaces to find the best fit:

• If a matching workspace exists (by name similarity), Cosmo uses it automatically
• If multiple workspaces could match, Cosmo asks you to choose
• Only if no workspace fits will Cosmo create a new one

This prevents duplicate workspaces and keeps your artifacts organized without manual overhead.

Viewing Artifacts

Navigating to Artifacts

1. In the Hub panel (right side), look at the Workspaces section in the Hub sidebar
2. Click on a workspace name to see its artifact list
3. Each artifact card shows the title, type badge (HTML), version number, and last-modified timestamp
4. Artifacts are sorted by most recently updated

Opening an Artifact

Click any artifact card to open it in the Hub canvas. The artifact renders as an interactive HTML page with:

• A sticky header at the top showing the artifact title, version badge, and navigation controls
• A back button to return to the workspace's artifact list
• A refresh button to manually reload the content
• The full artifact content below, including any interactive charts

Returning to the Hub

• Click the back arrow in the artifact header to return to the workspace's artifact list
• Click any Hub tab (Dashboard, Tasks, Daily Digest) to return to the main Hub views

Renaming Artifacts

You can rename an artifact directly from the Hub without going through chat.

From the workspace dashboard or artifact list

1. Hover over an artifact title — a pencil icon appears to the right
2. Click the pencil icon to enter rename mode (or press F2 when the title is focused via keyboard)
3. Type the new name and press Enter to confirm, or Escape to cancel
4. Clicking away from the input (blur) also cancels — no accidental renames

The new title appears immediately (optimistic update). A spinner replaces the pencil while the save is in-flight. If the save fails, the original title is restored and a brief error message is shown.

From the artifact viewer header

Double-click the title in the sticky header, or click the pencil icon that appears on hover, to rename the artifact while viewing its contents. (Double-click is available only in the viewer header — in list views, use the pencil icon or F2.)

Via chat

You can also rename an artifact by asking Cosmo in chat:

"Rename the Q3 proposal to Q3 Revenue Plan"

Modifying Artifacts

Artifacts are living documents. You can refine them through continued conversation with Cosmo.

Example modification prompts:

• "Update the revenue projection to $2M in the Q3 proposal"
• "Add a pie chart for market share breakdown"
• "Change the executive summary to focus on cost savings"
• "Add a new section about implementation timeline"

When you ask Cosmo to modify an artifact, it will:

1. Read the current content of the artifact
2. Make the requested changes while preserving the rest of the document
3. Save the updated version (the version number increments automatically)
4. The Hub viewer refreshes automatically to show the latest version

Moving Artifacts Between Workspaces

You can move artifacts from one workspace to another through chat. This is useful when you reorganize or realize an artifact belongs somewhere else.

Example prompts:

• "Move the Q3 proposal to the ACME Corp workspace"
• "Transfer the competitive analysis artifact to the Strategy workspace"
• "Move all the budget artifacts to the Finance workspace"

When you move an artifact:

• The artifact's content, version history, and metadata are preserved
• Only the workspace association changes
• The Hub updates in both the source and destination workspaces immediately

Charts and Visualizations

Artifacts support rich Chart.js visualizations. You can ask Cosmo to include:

• Bar charts — for comparisons, revenue breakdowns, category data
• Line charts — for trends, time series, projections
• Pie / Doughnut charts — for proportions, market share, budget allocation
• Radar charts — for multi-dimensional comparisons
• Mixed charts — combining multiple chart types

Charts render interactively inside the artifact viewer with tooltips and hover effects.

Tips for better charts:

• Be specific about what data to visualize: "Create a bar chart comparing Q1-Q4 revenue"
• Ask for multiple charts in one artifact: "Include both a revenue trend line and a cost breakdown pie chart"
• Request specific chart types when you have a preference

Versioning

Every time an artifact is modified, its version number increments automatically. The current version is displayed in the artifact header as a badge (e.g., "v3"). This lets you and your team know how many iterations the document has gone through.

Team Collaboration

Artifacts are stored in the shared space of your organization. This means:

• All team members in the organization can see workspace artifacts
• Changes made through any team member's chat session are reflected for everyone
• The Hub auto-refreshes when artifacts are created or updated

Best Practices

1. One artifact per topic — Keep each artifact focused. Create separate artifacts for the proposal, the financial model, and the timeline rather than cramming everything into one.

2. Use workspaces to organize — Group related artifacts under the same workspace. A client engagement might have a proposal, SOW, and status report as separate artifacts.

3. Iterate through chat — Don't recreate artifacts from scratch. Ask Cosmo to modify the existing one to preserve context and version history.

4. Be specific with chart requests — "Add a chart" is less effective than "Add a bar chart comparing Q1-Q4 revenue with target vs actual".

5. Review in the Hub — Always check the rendered artifact in the Hub viewer. The HTML rendering may look different from what you imagined — if so, just ask Cosmo to adjust.