docs: add Altimate LLM Gateway provider, expand IDE page, update quic… (#607)

arora-saurabh448 · Saurabh Arora · claude · web-flow · commit 06c4c84aa4ec · 2026-04-04T11:29:18.000-07:00
* docs: add Altimate LLM Gateway provider, expand IDE page, update quickstart

- Rewrite IDE page: generic setup for VS Code/Cursor via Datamates extension, Cmd+Shift+P flow, features, LLM access options
- Add Altimate LLM Gateway as first provider in providers.md (condensed format, links to Datamates docs for full details)
- Add Gateway tip in quickstart Step 2 (10M tokens free, links to Datamates docs)
- Update ecosystem.md with Datamates and Windsurf links

Co-Authored-By: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;

* docs: fix ZDR wording, add CLI prerequisite, add Windsurf to IDE page

- providers.md: remove ZDR and subprocessor claims, keep accurate
  metadata bullet
- ide.md: add npm install -g altimate-code as prerequisite,
  add Windsurf install instruction, rename title to "IDE Integration"

Co-Authored-By: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;

* docs: strip gateway data handling details from providers.md

Keep only config snippet and link to Datamates docs for full
gateway details. Remove security/data handling bullets — this
info lives in Datamates and dbtPU docs only.

Co-Authored-By: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;

---------

Co-authored-by: Saurabh Arora &lt;saurabh@altimate.ai&gt;
Co-authored-by: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/docs/docs/configure/providers.md b/docs/docs/configure/providers.md
@@ -23,6 +23,21 @@ Each provider has a key in the `provider` object:
 !!! tip
     Use `{env:...}` substitution for API keys so you never commit secrets to version control.
 
+## Altimate LLM Gateway
+
+Managed LLM access with dynamic routing across Sonnet 4.6, Opus 4.6, GPT-5.4, GPT-5.3, and more. No API keys to manage — 10M tokens free to get started.
+
+```json
+{
+  "provider": {
+    "altimate": {}
+  },
+  "model": "altimate/auto"
+}
+```
+
+For pricing, security, and data handling details, see the [Altimate LLM Gateway guide](https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/).
+
 ## Anthropic
 
 ```json
diff --git a/docs/docs/develop/ecosystem.md b/docs/docs/develop/ecosystem.md
@@ -14,7 +14,8 @@ altimate has a growing ecosystem of plugins, tools, and integrations.
 
 - **GitHub Actions**: Automated PR review and issue triage
 - **GitLab CI**: Merge request analysis
-- **VS Code / Cursor**: IDE integration
+- **VS Code / Cursor / Windsurf**: [IDE integration](../usage/ide.md) via the Datamates extension
+- **[Datamates](https://datamates-docs.myaltimate.com/)**: AI teammates platform with MCP integrations, Knowledge Hub, Memory, and Guardrails
 - **MCP**: Model Context Protocol servers
 - **ACP**: Agent Communication Protocol for editors
 
diff --git a/docs/docs/getting-started/quickstart-new.md b/docs/docs/getting-started/quickstart-new.md
@@ -28,6 +28,9 @@ export ANTHROPIC_API_KEY=sk-ant-...
 altimate
 ```
 
+!!! tip "Don't want to manage API keys?"
+    The [Altimate LLM Gateway](https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/) gives you 10M tokens free — no API keys needed. It dynamically routes to the best model for each task across Sonnet 4.6, Opus 4.6, GPT-5.4, and more.
+
 ---
 
 ## Step 3: Connect Your Warehouse
diff --git a/docs/docs/usage/ide.md b/docs/docs/usage/ide.md
@@ -1,28 +1,56 @@
-# IDE
+# IDE Integration
 
-altimate integrates with VS Code and Cursor as an AI assistant.
+altimate-code integrates with your IDE via the [Datamates extension](https://marketplace.visualstudio.com/items?itemName=altimateai.vscode-altimate-mcp-server), giving you AI-powered chat with 100+ data engineering tools directly in your editor.
 
-!!! warning "Beta"
-    IDE integration is currently in beta. Features may change.
+---
 
-## VS Code / Cursor
+## Prerequisites
 
-### Setup
+Install the altimate-code CLI globally:
 
-1. Install the altimate extension from the marketplace
-2. Ensure `altimate` is installed globally:
-   ```bash
-   npm install -g altimate-code
-   ```
-3. The extension will auto-detect the CLI
+```bash
+npm install -g altimate-code
+```
 
-### Features
+The Datamates extension requires this to be installed for the chat and tools to function.
 
-- Inline chat with altimate agents
-- File context awareness from your editor
-- Tool call results displayed inline
-- Agent mode switching from the command palette
+## Install the Extension
 
-### Configuration
+Install the Datamates extension for your IDE:
 
-The extension uses your existing `altimate-code.json` config. No additional IDE configuration is required.
+- **VS Code** — [Microsoft Marketplace](https://marketplace.visualstudio.com/items?itemName=altimateai.vscode-altimate-mcp-server)
+- **Cursor / other VS Code-compatible editors** — [Open VSX Registry](https://open-vsx.org/extension/altimateai/vscode-altimate-mcp-server)
+- **Windsurf** — Install via the built-in extension marketplace (search "Datamates")
+
+## Open Altimate Code Chat
+
+After installing the extension:
+
+1. Press `Cmd+Shift+P` (macOS) or `Ctrl+Shift+P` (Windows/Linux) to open the command palette
+2. Type `Datamates`
+3. Select **Datamates: Open Altimate Code Chat**
+
+This opens the Altimate Code chat panel where you can interact with altimate agents and use all 100+ data engineering tools.
+
+## Features
+
+- **Inline chat** with altimate agents — ask questions, run tools, and get results directly in your editor
+- **File context awareness** — the agent sees your open files and project structure
+- **Tool call results inline** — SQL analysis, lineage, dbt operations, and more displayed in the chat
+- **Agent mode switching** — switch between Builder (full read/write), Analyst (read-only), and Plan (minimal access) modes from the command palette
+- **100+ data engineering tools** — SQL validation, query optimization, column lineage, dbt model generation, FinOps analysis, schema exploration, and more
+
+## Configuration
+
+The extension uses your existing `altimate-code.json` config. No additional IDE-specific configuration is required. Warehouse connections, LLM providers, permissions, and agent settings all carry over.
+
+## LLM Access
+
+You need an LLM to power the chat. Two options:
+
+- **BYOK (Bring Your Own Key)** — Free and unlimited. Configure any of the [35+ supported providers](../configure/providers.md) (Anthropic, OpenAI, AWS Bedrock, Azure OpenAI, etc.)
+- **[Altimate LLM Gateway](https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/)** — Managed LLM access with dynamic model routing. 10M tokens free to get started — no API keys to manage
+
+## Full Datamates Documentation
+
+The Datamates extension offers additional capabilities beyond Altimate Code Chat, including MCP server integrations, Knowledge Hub, Memory Hub, and Guardrails. See the [Datamates documentation](https://datamates-docs.myaltimate.com/) for full setup guides, integration configuration, and feature details.
