Skip to content

README.md

Latest commit

 

History

History
191 lines (131 loc) · 8.17 KB

README.md

File metadata and controls

191 lines (131 loc) · 8.17 KB
altimate-code

The data engineering agent for dbt, SQL, and cloud warehouses.

An AI-powered CLI with 99+ specialized tools — SQL analysis, schema inspection, column-level lineage, FinOps, PII detection, and data visualization. Connects to your warehouse, understands your data, and helps you ship faster.

npm npm License: MIT CI Docs

Why altimate?

General-purpose coding agents can write SQL, but they don't understand it. They can't trace lineage, detect anti-patterns, check PII exposure, or optimize warehouse costs — because they don't have the tools.

altimate is a fork of OpenCode rebuilt for data teams. It gives any LLM access to 99+ specialized data engineering tools, 12 purpose-built skills, and direct warehouse connectivity — so the AI works with your actual schemas, not guesses.

General agents vs altimate

Capability General coding agents altimate
SQL anti-pattern detection None 19 rules with confidence scoring
Column-level lineage None Automatic from SQL
Schema-aware autocomplete None Indexes your warehouse metadata
Cross-dialect translation None Snowflake, BigQuery, Databricks, Redshift
FinOps analysis None Credit analysis, expensive queries, warehouse sizing
PII detection None Automatic column scanning
dbt integration Basic file editing Manifest parsing, test generation, model scaffolding
Data visualization None Auto-generated charts from SQL results
Observability None Local-first tracing of AI sessions and tool calls

Quick demo

# Auto-detect your data stack (dbt projects, warehouse connections, installed tools)
> /discover

# Analyze a query for anti-patterns and optimization opportunities
> Analyze this query for issues: SELECT * FROM orders JOIN customers ON orders.id = customers.order_id

# Translate SQL across dialects
> /sql-translate this Snowflake query to BigQuery: SELECT DATEADD(day, 7, current_date())

# Generate dbt tests for a model
> /generate-tests for models/staging/stg_orders.sql

# Get a cost report for your Snowflake account
> /cost-report

Key Features

SQL Anti-Pattern Detection

19 rules with confidence scoring — catches SELECT *, cartesian joins, non-sargable predicates, correlated subqueries, and more. 100% accuracy on 1,077 benchmark queries.

Column-Level Lineage

Automatic lineage extraction from SQL. Trace any column back through joins, CTEs, and subqueries to its source. Works standalone or with dbt manifests for project-wide lineage. 100% edge match on 500 benchmark queries.

FinOps & Cost Analysis

Credit analysis, expensive query detection, warehouse right-sizing, unused resource cleanup, and RBAC auditing.

Cross-Dialect Translation

Transpile SQL between Snowflake, BigQuery, Databricks, Redshift, PostgreSQL, MySQL, SQL Server, and DuckDB.

PII Detection & Safety

Automatic column scanning for PII across 15 categories with 30+ regex patterns. Safety checks and policy enforcement before query execution.

dbt Native

Manifest parsing, test generation, model scaffolding, incremental model detection, and lineage-aware refactoring. 12 purpose-built skills including medallion patterns, yaml config generation, and dbt docs.

Data Visualization

Interactive charts and dashboards from SQL results. The data-viz skill generates publication-ready visualizations with automatic chart type selection based on your data.

Local-First Tracing

Built-in observability for AI interactions — trace tool calls, token usage, and session activity locally. No external services required. View traces with altimate trace.

AI Teammate Training

Teach your AI teammate project-specific patterns, naming conventions, and best practices. The training system learns from examples and applies rules automatically across sessions.

Install

# npm (recommended)
npm install -g @altimateai/altimate-code

# Homebrew
brew install AltimateAI/tap/altimate-code

Then:

altimate              # Launch the interactive TUI
altimate /discover    # Auto-detect your data stack and go

Note: altimate-code still works as a backward-compatible alias.

/discover auto-detects dbt projects, warehouse connections (from ~/.dbt/profiles.yml, Docker, environment variables), and installed tools (dbt, sqlfluff, airflow, dagster, and more).

Agent Modes

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

Agent 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
Executive Business-audience summaries — translates findings into revenue, cost, and compliance impact Read-only

Supported Warehouses

Snowflake · BigQuery · Databricks · PostgreSQL · Redshift · DuckDB · MySQL · SQL Server

First-class support with schema indexing, query execution, and metadata introspection. SSH tunneling available for secure connections.

Works with Any LLM

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

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.

Monorepo structure

packages/
  altimate-code/       TypeScript CLI (main entry point)
  dbt-tools/           dbt integration (TypeScript)
  plugin/              Plugin system
  sdk/js/              JavaScript SDK
  util/                Shared utilities

Documentation

Full docs at altimate.ai.

Community & Contributing

Contributions welcome! Please read the Contributing Guide before opening a PR.

git clone https://github.com/AltimateAI/altimate-code.git
cd altimate-code
bun install

Acknowledgements

altimate is a fork of OpenCode, the open-source AI coding agent. We build on top of their excellent foundation to add data-team-specific capabilities.

License

MIT — see LICENSE.