From 1bc4550f99de84783e5179617bd97e3871ec0d17 Mon Sep 17 00:00:00 2001 From: Saurabh Arora Date: Tue, 31 Mar 2026 17:35:06 -0700 Subject: [PATCH 1/3] 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) --- docs/docs/configure/providers.md | 22 +++++++++ docs/docs/develop/ecosystem.md | 3 +- docs/docs/getting-started/quickstart-new.md | 3 ++ docs/docs/usage/ide.md | 53 ++++++++++++++------- 4 files changed, 62 insertions(+), 19 deletions(-) diff --git a/docs/docs/configure/providers.md b/docs/docs/configure/providers.md index f27a14376d..df283e781e 100644 --- a/docs/docs/configure/providers.md +++ b/docs/docs/configure/providers.md @@ -23,6 +23,28 @@ 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" +} +``` + +The gateway dynamically routes each request to the best model for the task. You pay a flat token price regardless of which model handles your request. + +- Zero data retention — prompts and responses are never stored +- Uses Azure Foundry and AWS Bedrock as subprocessors with ZDR +- BYOK is always free and unlimited alongside the gateway +- Stores only metadata (token counts, latency) to improve model ranking and routing + +For full pricing tiers and 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 index 3f847d5d41..b3f67582ad 100644 --- 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 index 3586e7fae1..9b6d95b09c 100644 --- 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 index 34d51d5acd..c43f829b34 100644 --- a/docs/docs/usage/ide.md +++ b/docs/docs/usage/ide.md @@ -1,28 +1,45 @@ # IDE -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 +## Install the Extension -### Setup +Install the Datamates extension for your IDE: -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 +- **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) -### Features +## Open Altimate Code Chat -- Inline chat with altimate agents -- File context awareness from your editor -- Tool call results displayed inline -- Agent mode switching from the command palette +After installing the extension: -### Configuration +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** -The extension uses your existing `altimate-code.json` config. No additional IDE configuration is required. +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. From c30ecbea627c9504fa616edff71358947dc26469 Mon Sep 17 00:00:00 2001 From: Saurabh Arora Date: Thu, 2 Apr 2026 12:02:50 -0700 Subject: [PATCH 2/3] 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) --- docs/docs/configure/providers.md | 5 ++--- docs/docs/usage/ide.md | 13 ++++++++++++- 2 files changed, 14 insertions(+), 4 deletions(-) diff --git a/docs/docs/configure/providers.md b/docs/docs/configure/providers.md index df283e781e..a87e4c3dce 100644 --- a/docs/docs/configure/providers.md +++ b/docs/docs/configure/providers.md @@ -38,10 +38,9 @@ Managed LLM access with dynamic routing across Sonnet 4.6, Opus 4.6, GPT-5.4, GP The gateway dynamically routes each request to the best model for the task. You pay a flat token price regardless of which model handles your request. -- Zero data retention — prompts and responses are never stored -- Uses Azure Foundry and AWS Bedrock as subprocessors with ZDR +- Prompts and responses are not stored - BYOK is always free and unlimited alongside the gateway -- Stores only metadata (token counts, latency) to improve model ranking and routing +- Stores limited metadata (token counts, latency, model used) for billing and routing For full pricing tiers and details, see the [Altimate LLM Gateway guide](https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/). diff --git a/docs/docs/usage/ide.md b/docs/docs/usage/ide.md index c43f829b34..791796f0d6 100644 --- a/docs/docs/usage/ide.md +++ b/docs/docs/usage/ide.md @@ -1,15 +1,26 @@ -# IDE +# IDE Integration 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. --- +## Prerequisites + +Install the altimate-code CLI globally: + +```bash +npm install -g altimate-code +``` + +The Datamates extension requires this to be installed for the chat and tools to function. + ## Install the Extension Install the Datamates extension for your IDE: - **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 From 875f4c109bc02e9b1825623621bcada99262f8a9 Mon Sep 17 00:00:00 2001 From: Saurabh Arora Date: Thu, 2 Apr 2026 12:22:15 -0700 Subject: [PATCH 3/3] docs: strip gateway data handling details from providers.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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) --- docs/docs/configure/providers.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/docs/docs/configure/providers.md b/docs/docs/configure/providers.md index a87e4c3dce..b0db67fbcc 100644 --- a/docs/docs/configure/providers.md +++ b/docs/docs/configure/providers.md @@ -36,13 +36,7 @@ Managed LLM access with dynamic routing across Sonnet 4.6, Opus 4.6, GPT-5.4, GP } ``` -The gateway dynamically routes each request to the best model for the task. You pay a flat token price regardless of which model handles your request. - -- Prompts and responses are not stored -- BYOK is always free and unlimited alongside the gateway -- Stores limited metadata (token counts, latency, model used) for billing and routing - -For full pricing tiers and details, see the [Altimate LLM Gateway guide](https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/). +For pricing, security, and data handling details, see the [Altimate LLM Gateway guide](https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/). ## Anthropic