Datamates UI References — Pending Release¶

The docs moved from /datamates/ to /workspaces/ in AI-9194, and prose describing the product now says Workspaces. The references below deliberately still say Datamates, because each one names a string a user will literally see or type — a marketplace search term, a sidebar label, a command-palette entry, an MCP server name. Renaming them here before the software ships would document a product that does not exist yet.

The blocker changed since this file was written. It is no longer "nobody has decided": the renames exist and are in flight.

Surface	Where the rename lives	Unblocks when
VS Code extension UI, marketplace listing, command palette	`vscode-altimate-mcp-server#468`	the extension is published to the marketplace — not when the PR merges
SaaS screens, including the Studio picker	`altimate-frontend#3347` (AI-9181)	that deploys

Two groups will never unblock on their own, because the underlying thing keeps its name:

datamate as the MCP server name, the CLI binary, and @altimateai/datamate on npm
DATAMATES_URL, and the datamate key written into .vscode/mcp.json

Those rows stay as they are permanently. Recorded demos need re-recording rather than editing.

Extension Name in Marketplace¶

Users searching for and installing the extension will see "Datamates":

File	Line	Kept As
datamates/user-guide/setup/cline-setup.md	16–17	`Search for "Datamates"` / `Find Datamates by Altimate AI`
datamates/user-guide/setup/claude-code-setup.md	24–25	`Search for "Datamates"` / `Find Datamates by Altimate AI`
datamates/faq/troubleshooting.md	43	`Cannot find "Datamates" in VS Code marketplace`
datamates/faq/troubleshooting.md	419	`Install only Datamates`
code/usage/ide.md	28	`search "Datamates"` (Windsurf marketplace)

VS Code Extension Label¶

The extension appears as "Datamates" in the IDE sidebar, status bar, and extension panel:

File	Line	Kept As
datamates/user-guide/setup/cline-setup.md	23, 44	`the Datamates extension`
datamates/user-guide/setup/cline-setup.md	3	frontmatter description
datamates/user-guide/setup/claude-code-setup.md	18, 30, 64	`the Datamates extension` / `Datamates GUI`
datamates/user-guide/setup/cursor-setup.md	20	`Navigate to the Datamates menu by clicking Datamates on the sidebar`
datamates/user-guide/setup/vscode-setup.md	20	`Navigate to the Datamates menu by clicking Datamates on the sidebar`
datamates/user-guide/setup/vscode-setup.md	39	`Look for the Datamates icon in your sidebar`
datamates/faq/troubleshooting.md	9	`common issues with the Datamates extension`
datamates/faq/troubleshooting.md	160, 217	`Open the Datamates panel in the sidebar`
datamates/user-guide/components/altimate-code.md	3, 12	`integrated into the Datamates extension`
datamates/user-guide/components/llm-gateway.md	90	`Install the Datamates extension`
dbt-power-user/arch/llm-gateway.md	90	`Install the Datamates extension`
dbt-power-user/setup/installation.md	3, 7	`Datamates Extension`
dbt-power-user/teammates/altimate-code.md	12, 16	`through the Datamates extension` / `Install the Datamates Extension`
code/develop/ecosystem.md	22	`via the Datamates extension`
code/usage/ide.md	3, 8, 20, 24, 62	`the Datamates extension`
platform/discover-savings/closing-the-loop.md	16	`Datamates Extension`

VS Code Command Palette Commands¶

The extension registers these commands in VS Code. They appear verbatim in the command palette:

File	Line	Command
datamates/faq/troubleshooting.md	17	`Datamates: Run Altimate Diagnostics`
datamates/faq/troubleshooting.md	128	`Datamates: Run Altimate Diagnostics`
datamates/user-guide/setup/claude-code-setup.md	52	`Run: Datamates: Run Altimate Diagnostics`

UI Button Labels¶

These match actual clickable elements in the extension UI:

File	Line	Kept As
datamates/user-guide/setup/cline-setup.md	25	`Click Select datamate`
datamates/user-guide/setup/claude-code-setup.md	32	`Click Select datamate`
datamates/user-guide/setup/cline-setup.md	26	`top right of the Datamates menu`
datamates/user-guide/setup/claude-code-setup.md	33	`top right of the Datamates menu`
datamates/user-guide/setup/cursor-setup.md	28	`Verify that you see datamate as an installed MCP Server`

MCP Server Name in CLI Commands¶

datamate is the registered name of the MCP server. These appear in code blocks and CLI commands:

File	Line	Kept As
datamates/user-guide/setup/claude-code-setup.md	67	`claude mcp add --transport sse datamate http://localhost:7700/sse`
datamates/user-guide/setup/claude-code-setup.md	81	`datamate` - The name for this MCP server
datamates/user-guide/setup/claude-code-setup.md	109	`npm install -g @altimateai/datamate`
datamates/user-guide/setup/claude-code-setup.md	144	`datamate start --datamate 1 ...`
datamates/user-guide/setup/claude-code-setup.md	151	`setting this datamate for the first time`
datamates/user-guide/setup/claude-code-setup.md	156	`datamate mcp server should be listed`

Environment Variable¶

Set by the extension. Used in auto-generated MCP config files:

File	Line	Kept As
datamates/user-guide/setup/cline-setup.md	46	`${env:DATAMATES_URL}`

Iframe / Demo Titles¶

Recorded demos were made with the old product name. The title attribute matches the video content:

File	Kept As
datamates/user-guide/setup/cline-setup.md	`title="Install Datamates in Cline"`
datamates/user-guide/setup/claude-code-setup.md	`title="Install Datamates in Claude Code (UI)"`
datamates/user-guide/setup/claude-code-setup.md	`title="Install Datamates in Claude Code (Terminal)"`
datamates/user-guide/setup/cursor-setup.md	`title="Install Datamates in Cursor"`
datamates/user-guide/setup/vscode-setup.md	`title="Install Datamates in VSCode"`
datamates/examples/debug-airflow-dag.md	`title="AI Assisted Development w/ Datamates: Debugging Airflow DAGS"`
datamates/examples/find-broken-views-snowflake.md	`title="... Altimate AI Datamates Github Copilot"`
datamates/examples/write-snowflake-udfs.md	`title="Automate Creating Snowflake UDFs with Datamates"`
datamates/user-guide/home.md	`title="... Altimate AI Datamates Github Copilot"`

Prerequisite Admonitions¶

These admonition blocks tell users to install the extension before using a Power User for dbt feature. The extension name is "Datamates":

File	Line	Kept As
dbt-power-user/develop/explanation.md	9, 12	`Requires the Datamates extension` / `Make sure Datamates is installed and active`
dbt-power-user/develop/optimize.md	12, 15	same
dbt-power-user/develop/translateSQL.md	9, 12	same
dbt-power-user/develop/updatemodel.md	9, 12	same
dbt-power-user/test/writetests.md	34, 37	same

Marketplace Links with "Datamates" as Link Text¶

These links point to the extension listing, which is still titled "Datamates by Altimate AI":

File	Kept As
dbt-power-user/develop/explanation.md	`[Datamates](https://marketplace.visualstudio.com/...)`
dbt-power-user/develop/optimize.md	same
dbt-power-user/develop/translateSQL.md	same
dbt-power-user/develop/updatemodel.md	same
dbt-power-user/test/writetests.md	same

npm Package and Credentials¶

File	Line	Kept As
datamates/user-guide/home.md	10	`@altimateai/datamate` npm package link
datamates/user-guide/setup/cline-setup.md	28	`Select your Datamates' plan:`
datamates/user-guide/setup/claude-code-setup.md	35	`Select your Datamates' plan:`

What to Update, and When¶

Once the extension is published to the marketplace (vscode-altimate-mcp-server#468) — the new strings it ships are already known, so the replacements are decided:

Marketplace search text — Search for "Datamates" becomes Search for "Altimate Workspaces"
Extension label — the Datamates extension becomes the Altimate Workspaces extension
Command palette — Datamates: Run Altimate Diagnostics becomes Altimate Workspaces: Run Altimate Diagnostics
Sidebar / menu labels — the panel is Altimate Workspaces, the view is My Workspaces
Button labels — Select datamate becomes Select workspace; Configure/Change Datamate become Configure/Change Workspace
Screenshots — anything showing the old panel needs re-shooting

Publication is the gate, not the merge. A user reading a doc that says "search for Altimate Workspaces" while the marketplace still lists "Datamates" cannot complete the step.

Once the SaaS deploys (altimate-frontend#3347):

Studio / playground labels — the Datamates category, Add Datamate, and Select a Datamate in platform/ai-agents/playground.md

Never, unless the artifact itself is renamed:

datamate as the MCP server name and CLI binary, @altimateai/datamate, DATAMATES_URL, and the datamate key in .vscode/mcp.json
Recorded demos — the iframe titles match video content; they change only when the videos are re-recorded

Out of scope here, deliberately:

platform/guides/release-notes.md — release notes are a historical record. Entries describing what shipped as "Datamates" stay as written.
Glossary — the "Datamates" (old name) note in resources/glossary.md becomes more useful after the rename, not less. It should stay until the old name stops appearing in support conversations.