From 535956b62f3595c0fada41adbd3f199fd1a762a9 Mon Sep 17 00:00:00 2001 From: Saurabh Arora Date: Wed, 18 Mar 2026 20:48:37 -0700 Subject: [PATCH 1/6] fix: README with latest changes --- README.md | 27 +++++++++++++-------------- 1 file changed, 13 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 7a9850dcb..1f67ebc54 100644 --- a/README.md +++ b/README.md @@ -57,6 +57,8 @@ altimate /discover `/discover` auto-detects dbt projects, warehouse connections (from `~/.dbt/profiles.yml`, Docker, environment variables), and installed tools (dbt, sqlfluff, airflow, dagster, and more). Skip this and start building — you can always run it later. +> **Headless / scripted usage:** `altimate --yolo` auto-approves all permission prompts. Not recommended with live warehouse connections. + > **Zero additional setup.** One command install. ## Why a specialized harness? @@ -89,7 +91,7 @@ no hallucinated SQL advice, no guessing at schema, no missed PII. - **FinOps** — credit consumption, expensive query detection, warehouse right-sizing, idle resource cleanup - **PII Detection** — 15 categories, 30+ regex patterns, enforced pre-execution -**Works seamlessly with Claude Code and Codex.** altimate is the data engineering tool layer — use it standalone in your terminal, or mount it as the harness underneath whatever AI agent you already run. The two are complementary. +**Works seamlessly with Claude Code and Codex.** Use `/configure-claude` or `/configure-codex` to set up integration in one step. altimate is the data engineering tool layer — use it standalone in your terminal, or mount it as the harness underneath whatever AI agent you already run. The two are complementary. altimate is a fork of [OpenCode](https://github.com/anomalyco/opencode) rebuilt for data teams. Model-agnostic — bring your own LLM or run locally with Ollama. @@ -145,19 +147,15 @@ Teach your AI teammate project-specific patterns, naming conventions, and best p ## Agent Modes -Each agent has scoped permissions and purpose-built tools for its role. +Each mode has scoped permissions, tool access, and SQL write-access control. -| Agent | Role | Access | +| Mode | Role | Access | |---|---|---| -| **Builder** | Create dbt models, SQL pipelines, and data transformations | Full read/write | -| **Analyst** | Explore data, run SELECT queries, and generate insights | Read-only enforced | -| **Validator** | Data quality checks, schema validation, test coverage analysis | Read + validate | -| **Migrator** | Cross-warehouse SQL translation, schema migration, dialect conversion | Read/write for migrations | -| **Researcher** | Deep-dive analysis, documentation research, and knowledge extraction | Read-only | -| **Trainer** | Teach project-specific patterns, naming conventions, and best practices | Read + write training data | -| **Executive** | Business-audience summaries — translates findings into revenue, cost, and compliance impact | Read-only | +| **Builder** | Create dbt models, SQL pipelines, and data transformations | Full read/write (write SQL prompts for approval; `DROP DATABASE`/`DROP SCHEMA`/`TRUNCATE` hard-blocked) | +| **Analyst** | Explore data, run SELECT queries, FinOps analysis, and generate insights | Read-only enforced (SELECT only, no file writes) | +| **Plan** | Outline an approach before acting | Minimal (read files only, no SQL or bash) | -> **New to altimate?** Start with **Analyst mode** — it's read-only and safe to run against production connections. +> **New to altimate?** Start with **Analyst mode** — it's read-only and safe to run against production connections. Need specialized workflows (validation, migration, research)? Create [custom agent modes](https://docs.altimate.sh). ## Supported Warehouses @@ -200,7 +198,7 @@ The CLI handles AI interactions, TUI, and tool orchestration. SQL analysis is po ``` packages/ - altimate-code/ TypeScript CLI (main entry point) + opencode/ TypeScript CLI (main entry point) drivers/ Shared database drivers (10 warehouses) dbt-tools/ dbt integration (TypeScript) plugin/ Plugin system @@ -221,9 +219,10 @@ Contributions welcome — docs, SQL rules, warehouse connectors, and TUI improve ## Changelog +- **v0.5.0** (March 2026) — smooth streaming mode, builtin skills via postinstall, `/configure-claude` and `/configure-codex` commands, warehouse auth hardening +- **v0.4.9** (March 2026) — Snowflake auth overhaul (all auth methods), dbt tool regression fixes, parallel CI builds - **v0.4.2** (March 2026) — yolo mode, Python engine elimination (all-native TypeScript), tool consolidation, path sandboxing hardening, altimate-dbt CLI, unscoped npm package -- **v0.4.1** (March 2026) — env-based skill selection, session caching, tracing improvements -- **v0.4.0** (Feb 2026) — data visualization skill, 100+ tools, training system +- **v0.4.0** (March 2026) — data visualization skill, 100+ tools, training system - **v0.3.x** — [See full changelog →](CHANGELOG.md) ## License From de14f4ad459eac4b163c4aa0d152feece4d5432e Mon Sep 17 00:00:00 2001 From: Saurabh Arora Date: Wed, 18 Mar 2026 20:53:18 -0700 Subject: [PATCH 2/6] fix: docs site logo and header --- docs/docs/assets/css/extra.css | 10 + .../images/altimate-code-banner-sml.png | Bin 0 -> 4479 bytes docs/docs/index.md | 189 +----------------- docs/mkdocs.yml | 2 +- 4 files changed, 15 insertions(+), 186 deletions(-) create mode 100644 docs/docs/assets/images/altimate-code-banner-sml.png diff --git a/docs/docs/assets/css/extra.css b/docs/docs/assets/css/extra.css index 4a62c26c0..57f04e0ed 100644 --- a/docs/docs/assets/css/extra.css +++ b/docs/docs/assets/css/extra.css @@ -1,3 +1,13 @@ +/* --- Header: banner logo replaces site-name text --- */ +.md-header__button.md-logo img { + height: 1.6rem; + width: auto; +} + +.md-header__ellipsis > .md-header__topic:first-child { + display: none; +} + /* Make nav section headers more prominent */ .md-nav--primary > .md-nav__list > .md-nav__item--section > .md-nav__link { font-weight: 700; diff --git a/docs/docs/assets/images/altimate-code-banner-sml.png b/docs/docs/assets/images/altimate-code-banner-sml.png new file mode 100644 index 0000000000000000000000000000000000000000..66a6c6ade15266735140012b85da1d4f5219b240 GIT binary patch literal 4479 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 literal 0 HcmV?d00001 diff --git a/docs/docs/index.md b/docs/docs/index.md index 63085ca92..19bff65f4 100644 --- a/docs/docs/index.md +++ b/docs/docs/index.md @@ -1,191 +1,10 @@ --- -title: altimate +title: altimate-code hide: - toc + - navigation --- - + -
- -

- altimate-code -

- -

The open-source data engineering harness.

- -

100+ tools for building, validating, optimizing, and shipping data products. Use in your terminal, CI pipeline, orchestration DAGs, or as the harness for your data agents. Evaluate across any platform, independent of a single warehouse provider.

- -

- -[Get Started](getting-started.md){ .md-button .md-button--primary } -[View on GitHub :material-github:](https://github.com/AltimateAI/altimate-code){ .md-button } - -

- -
- -
- -```bash -npm install -g altimate-code -``` - -
- ---- - -

Purpose-built for the data product lifecycle

-

Every tool covers a specific stage: build, validate, optimize, or ship. Not general-purpose AI on top of SQL files.

- -
- -- :material-database-search:{ .lg .middle } **SQL Anti-Pattern Detection** - - --- - - 19 rules with confidence scoring. Catches SELECT *, missing filters, cartesian joins, non-sargable predicates, and more. - -- :material-graph-outline:{ .lg .middle } **Column-Level Lineage** - - --- - - Automatic lineage extraction from SQL. Trace any column back through joins, CTEs, and subqueries to its source. - -- :material-cash-multiple:{ .lg .middle } **FinOps & Cost Analysis** - - --- - - Credit analysis, expensive query detection, warehouse right-sizing, and unused resource cleanup. - -- :material-translate:{ .lg .middle } **Cross-Dialect Translation** - - --- - - Transpile SQL between Snowflake, BigQuery, Databricks, Redshift, PostgreSQL, and more. - -- :material-shield-lock-outline:{ .lg .middle } **PII Detection & Safety** - - --- - - Automatic column scanning for PII. Safety checks and policy enforcement before every query execution. - -- :material-pipe:{ .lg .middle } **dbt Native** - - --- - - Manifest parsing, test generation, model scaffolding, incremental model detection, and lineage-aware refactoring. - -
- ---- - -

Use anywhere in your stack

-

Run interactively, automate in CI, embed in DAGs, or mount as the tool layer for your AI agents.

- -
- -- :material-console:{ .lg .middle } **Terminal** - - --- - - Interactive TUI with 100+ tools, autocomplete for skills, and persistent memory across sessions. - -- :material-pipe-disconnected:{ .lg .middle } **CI Pipeline** - - --- - - Headless mode for automated validation, schema diffing, and anti-pattern checks in GitHub Actions or any CI system. - -- :material-graph:{ .lg .middle } **Orchestration DAGs** - - --- - - Call the harness from Airflow, Dagster, or Prefect tasks to add data quality gates and lineage checks to your pipelines. - -- :material-robot-outline:{ .lg .middle } **Data Agent Harness** - - --- - - Mount altimate as the tool layer underneath Claude Code, Codex, or any AI agent, giving it deterministic, warehouse-aware capabilities. - -
- ---- - -

Purpose-built agent modes

-

Each agent has scoped permissions and purpose-built tools for its role.

- -
- -- :material-hammer-wrench:{ .lg .middle } **Builder** - - --- - - Create dbt models, SQL pipelines, and data transformations with full read/write access. SQL writes prompt for approval. Destructive SQL is hard-blocked. - -- :material-chart-bar:{ .lg .middle } **Analyst** - - --- - - Explore data, run SELECT queries, and generate insights. Read-only access is enforced. SQL writes are denied, not prompted. Safe bash commands auto-allowed. - -- :material-clipboard-text:{ .lg .middle } **Plan** - - --- - - Plan before acting. Read-only with minimal permissions. No SQL, no bash, no file modifications. - -
- -Create custom agents with tailored permissions for specialized workflows like validation, migration, research, or executive reporting. See [Agent Configuration](configure/agents.md#custom-agents). - ---- - -

Works with any LLM

-

Model-agnostic. Bring your own provider or run locally.

- -
- -- :material-cloud: **Anthropic** -- :material-creation: **OpenAI** -- :material-google: **Google** -- :material-aws: **AWS Bedrock** -- :material-microsoft-azure: **Azure OpenAI** -- :material-server: **Ollama** -- :material-router-wireless: **OpenRouter** - -
- ---- - -

Evaluate across any platform

-

First-class support for 10 databases. Migrate, compare, and translate across platforms, not locked to one vendor.

- -
- -- :material-snowflake: **Snowflake** -- :material-google-cloud: **BigQuery** -- :simple-databricks: **Databricks** -- :material-elephant: **PostgreSQL** -- :material-aws: **Redshift** -- :material-duck: **DuckDB** -- :material-database: **MySQL** -- :material-microsoft: **SQL Server** -- :material-database-outline: **Oracle** -- :material-database-search: **SQLite** - -
- ---- - -
- -**Documentation**: [Getting Started](getting-started.md) | [Guides](data-engineering/guides/cost-optimization.md) | [Tools](data-engineering/tools/sql-tools.md) | [Configuration](configure/config.md) - -**Extend**: [SDK](develop/sdk.md) | [Plugins](develop/plugins.md) | [Server API](develop/server.md) - -
+Redirecting to [Getting Started](getting-started/index.md)... diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index 9a4635260..70daa5171 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -9,7 +9,7 @@ copyright: "© 2026 Altimate Inc. All rights reserved." theme: name: material custom_dir: docs/overrides - logo: assets/logo.png + logo: assets/images/altimate-code-banner-sml.png favicon: assets/images/favicon.png font: text: Inter From f6c97d2a7c3ac848a4697e595869df0d21dbdde8 Mon Sep 17 00:00:00 2001 From: Saurabh Arora Date: Wed, 18 Mar 2026 21:03:15 -0700 Subject: [PATCH 3/6] fix: remove downloads and CI badges, update Slack link in README Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 1f67ebc54..edd23893a 100644 --- a/README.md +++ b/README.md @@ -14,10 +14,8 @@ Run standalone in your terminal, embed underneath Claude Code or Codex, or integ into CI pipelines and orchestration DAGs. Precision data tooling for any LLM. [![npm](https://img.shields.io/npm/v/altimate-code)](https://www.npmjs.com/package/altimate-code) -[![npm downloads](https://img.shields.io/npm/dm/altimate-code)](https://www.npmjs.com/package/altimate-code) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE) -[![CI](https://github.com/AltimateAI/altimate-code/actions/workflows/ci.yml/badge.svg)](https://github.com/AltimateAI/altimate-code/actions/workflows/ci.yml) -[![Slack](https://img.shields.io/badge/Slack-Join%20Community-4A154B?logo=slack)](https://altimate.ai/slack) +[![Slack](https://img.shields.io/badge/Slack-Join%20Community-4A154B?logo=slack)](https://altimate.studio/join-agentic-data-engineering-slack) [![Docs](https://img.shields.io/badge/docs-docs.altimate.sh-blue)](https://docs.altimate.sh) @@ -208,7 +206,7 @@ packages/ ## Community & Contributing -- **Slack**: [altimate.ai/slack](https://altimate.ai/slack) — Real-time chat for questions, showcases, and feature discussion +- **Slack**: [Join Slack](https://altimate.studio/join-agentic-data-engineering-slack) — Real-time chat for questions, showcases, and feature discussion - **Issues**: [GitHub Issues](https://github.com/AltimateAI/altimate-code/issues) — Bug reports and feature requests - **Discussions**: [GitHub Discussions](https://github.com/AltimateAI/altimate-code/discussions) — Long-form questions and proposals - **Security**: See [SECURITY.md](./SECURITY.md) for responsible disclosure From fc739b670af64d6ed413468ac6e1a6a8b4ac457c Mon Sep 17 00:00:00 2001 From: Saurabh Arora Date: Wed, 18 Mar 2026 21:06:14 -0700 Subject: [PATCH 4/6] fix: remove misleading "no API key" Codex references from README and docs Codex requires OAuth authentication, so the previous messaging suggesting it needs "no setup" was misleading. Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 4 ---- docs/docs/getting-started/quickstart-new.md | 2 -- docs/docs/getting-started/quickstart.md | 4 +--- docs/docs/quickstart.md | 4 +--- 4 files changed, 2 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index edd23893a..9d644ad80 100644 --- a/README.md +++ b/README.md @@ -40,8 +40,6 @@ altimate # Launch the TUI /connect # Interactive setup — choose your provider and enter your API key ``` -> **No API key?** Select **Codex** in the `/connect` menu — it's built-in and requires no setup. - Or set an environment variable directly: ```bash export ANTHROPIC_API_KEY=your_key # Anthropic Claude @@ -167,8 +165,6 @@ Model-agnostic — bring your own provider or run locally. Anthropic · OpenAI · Google Gemini · Google Vertex AI · Amazon Bedrock · Azure OpenAI · Mistral · Groq · DeepInfra · Cerebras · Cohere · Together AI · Perplexity · xAI · OpenRouter · Ollama · GitHub Copilot -> **No API key?** **Codex** is a built-in provider with no key required. Select it via `/connect` to start immediately. - ## Skills altimate ships with built-in skills for every common data engineering task — type `/` in the TUI to browse available skills and get autocomplete. No memorization required. diff --git a/docs/docs/getting-started/quickstart-new.md b/docs/docs/getting-started/quickstart-new.md index 44ecc3540..730556878 100644 --- a/docs/docs/getting-started/quickstart-new.md +++ b/docs/docs/getting-started/quickstart-new.md @@ -30,8 +30,6 @@ export ANTHROPIC_API_KEY=sk-ant-... altimate ``` -> **No API key?** Select **Codex** in `/connect` — it's built-in with no setup. - --- ## Step 3: Connect Your Warehouse diff --git a/docs/docs/getting-started/quickstart.md b/docs/docs/getting-started/quickstart.md index d4395cfc0..b0f15076c 100644 --- a/docs/docs/getting-started/quickstart.md +++ b/docs/docs/getting-started/quickstart.md @@ -4,7 +4,7 @@ description: "Install altimate-code, connect your warehouse and LLM, configure a # Setup -> **You need:** npm 8+ or Homebrew. An API key for any supported LLM provider, or use Codex (built-in, no key required). +> **You need:** npm 8+ or Homebrew. An API key for any supported LLM provider. --- @@ -49,8 +49,6 @@ Minimal config file option (`altimate-code.json` in your project root): } ``` -> **No API key?** Select **Codex** in the `/connect` menu. It's a built-in provider with no setup required. - ### Changing your LLM provider Switch providers at any time by updating the `provider` and `model` fields in `altimate-code.json`: diff --git a/docs/docs/quickstart.md b/docs/docs/quickstart.md index 273c5bec2..463f3f12d 100644 --- a/docs/docs/quickstart.md +++ b/docs/docs/quickstart.md @@ -4,7 +4,7 @@ description: "Install altimate-code and run your first SQL analysis. The open-so # Quickstart -> **You need:** npm 8+ or Homebrew. An API key for any supported LLM provider, or use Codex (built-in, no key required). +> **You need:** npm 8+ or Homebrew. An API key for any supported LLM provider. --- @@ -48,8 +48,6 @@ Minimal config file option (`altimate-code.json` in your project root): } ``` -> **No API key?** Select **Codex** in the `/connect` menu. It's a built-in provider with no setup required. - --- ## Step 3: Connect Your Warehouse _(Optional)_ From 9d2b8332c1e01d8e270cb178ef1b613ca4f69081 Mon Sep 17 00:00:00 2001 From: Saurabh Arora Date: Wed, 18 Mar 2026 21:07:49 -0700 Subject: [PATCH 5/6] fix: remove monorepo structure section from README Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 12 ------------ 1 file changed, 12 deletions(-) diff --git a/README.md b/README.md index 9d644ad80..2200a992e 100644 --- a/README.md +++ b/README.md @@ -188,18 +188,6 @@ The CLI handles AI interactions, TUI, and tool orchestration. SQL analysis is po **dbt-first**: When working in a dbt project, the CLI automatically uses dbt's connection from `profiles.yml` — no separate warehouse configuration needed. -### Monorepo structure - -``` -packages/ - opencode/ TypeScript CLI (main entry point) - drivers/ Shared database drivers (10 warehouses) - dbt-tools/ dbt integration (TypeScript) - plugin/ Plugin system - sdk/ SDKs (includes VS Code extension) - util/ Shared utilities -``` - ## Community & Contributing - **Slack**: [Join Slack](https://altimate.studio/join-agentic-data-engineering-slack) — Real-time chat for questions, showcases, and feature discussion From 4dc00263e03040879f07d164b9da1aea1f65f162 Mon Sep 17 00:00:00 2001 From: Saurabh Arora Date: Wed, 18 Mar 2026 21:08:54 -0700 Subject: [PATCH 6/6] fix: remove architecture section from README Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 19 ------------------- 1 file changed, 19 deletions(-) diff --git a/README.md b/README.md index 2200a992e..f9ec72640 100644 --- a/README.md +++ b/README.md @@ -169,25 +169,6 @@ Anthropic · OpenAI · Google Gemini · Google Vertex AI · Amazon Bedrock · Az altimate ships with built-in skills for every common data engineering task — type `/` in the TUI to browse available skills and get autocomplete. No memorization required. -## Architecture - -``` -altimate (TypeScript CLI) - | - @altimateai/altimate-core (napi-rs → Rust) - SQL analysis, lineage, PII, safety — 45 functions, ~2ms per call - | - Native Node.js drivers - 10 warehouses: Snowflake, BigQuery, PostgreSQL, Databricks, - Redshift, MySQL, SQL Server, Oracle, DuckDB, SQLite -``` - -The CLI handles AI interactions, TUI, and tool orchestration. SQL analysis is powered by the Rust-based `@altimateai/altimate-core` engine via napi-rs bindings (no Python required). Database connectivity uses native Node.js drivers with lazy loading. - -**No Python dependency**: All 73 tool methods run natively in TypeScript. No pip, venv, or Python installation needed. - -**dbt-first**: When working in a dbt project, the CLI automatically uses dbt's connection from `profiles.yml` — no separate warehouse configuration needed. - ## Community & Contributing - **Slack**: [Join Slack](https://altimate.studio/join-agentic-data-engineering-slack) — Real-time chat for questions, showcases, and feature discussion