You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
**Step 1: Configure your LLM provider** (required before anything works):
41
+
```bash
42
+
altimate # Launch the TUI
43
+
/connect # Interactive setup — choose your provider and enter your API key
44
+
```
45
+
46
+
> **No API key?** Select **Codex** in the `/connect` menu — it's built-in and requires no setup.
22
47
23
-
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.
48
+
Or set an environment variable directly:
49
+
```bash
50
+
export ANTHROPIC_API_KEY=your_key # Anthropic Claude
51
+
export OPENAI_API_KEY=your_key # OpenAI
52
+
```
53
+
54
+
**Step 2 (optional): Auto-detect your data stack** (read-only, safe for production connections):
55
+
```bash
56
+
altimate /discover
57
+
```
58
+
59
+
`/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.
60
+
61
+
> **Zero Python setup required.** On first run, the CLI automatically downloads [`uv`](https://github.com/astral-sh/uv), creates an isolated Python environment, and installs the data engine with all warehouse drivers. No `pip install`, no virtualenv management.
24
62
25
-
altimate is a fork of [OpenCode](https://github.com/anomalyco/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.
63
+
## Why a specialized harness?
26
64
27
-
## General agents vs altimate
65
+
General AI coding agents can edit SQL files. They cannot *understand* your data stack.
66
+
altimate gives any LLM a deterministic data engineering intelligence layer —
67
+
no hallucinated SQL advice, no guessing at schema, no missed PII.
**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.
94
+
95
+
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.
96
+
41
97
## Quick demo
42
98
43
99
```bash
@@ -59,6 +115,8 @@ altimate is a fork of [OpenCode](https://github.com/anomalyco/opencode) rebuilt
59
115
60
116
## Key Features
61
117
118
+
All features are deterministic — they parse, trace, and measure. Not LLM pattern matching.
119
+
62
120
### SQL Anti-Pattern Detection
63
121
19 rules with confidence scoring — catches SELECT *, cartesian joins, non-sargable predicates, correlated subqueries, and more. **100% accuracy** on 1,077 benchmark queries.
64
122
@@ -86,27 +144,6 @@ Built-in observability for AI interactions — trace tool calls, token usage, an
86
144
### AI Teammate Training
87
145
Teach your AI teammate project-specific patterns, naming conventions, and best practices. The training system learns from examples and applies rules automatically across sessions.
88
146
89
-
## Install
90
-
91
-
```bash
92
-
# npm (recommended)
93
-
npm install -g altimate-code
94
-
95
-
# Homebrew
96
-
brew install AltimateAI/tap/altimate-code
97
-
```
98
-
99
-
Then:
100
-
101
-
```bash
102
-
altimate # Launch the interactive TUI
103
-
altimate /discover # Auto-detect your data stack and go
104
-
```
105
-
106
-
>**Note:**`altimate-code` still works as a backward-compatible alias.
107
-
108
-
`/discover` auto-detects dbt projects, warehouse connections (from `~/.dbt/profiles.yml`, Docker, environment variables), and installed tools (dbt, sqlfluff, airflow, dagster, and more).
109
-
110
147
## Agent Modes
111
148
112
149
Each agent has scoped permissions and purpose-built tools for its role.
@@ -117,8 +154,12 @@ Each agent has scoped permissions and purpose-built tools for its role.
117
154
|**Analyst**| Explore data, run SELECT queries, and generate insights | Read-only enforced |
118
155
|**Validator**| Data quality checks, schema validation, test coverage analysis | Read + validate |
|**Trainer**| Teach project-specific patterns, naming conventions, and best practices | Read + write training data |
120
159
|**Executive**| Business-audience summaries — translates findings into revenue, cost, and compliance impact | Read-only |
121
160
161
+
>**New to altimate?** Start with **Analyst mode** — it's read-only and safe to run against production connections.
162
+
122
163
## Supported Warehouses
123
164
124
165
Snowflake · BigQuery · Databricks · PostgreSQL · Redshift · DuckDB · MySQL · SQL Server
@@ -131,6 +172,12 @@ Model-agnostic — bring your own provider or run locally.
131
172
132
173
Anthropic · OpenAI · Google Gemini · Google Vertex AI · Amazon Bedrock · Azure OpenAI · Mistral · Groq · DeepInfra · Cerebras · Cohere · Together AI · Perplexity · xAI · OpenRouter · Ollama · GitHub Copilot
133
174
175
+
> **No API key?** **Codex** is a built-in provider with no key required. Select it via `/connect` to start immediately.
176
+
177
+
## Skills
178
+
179
+
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.
180
+
134
181
## Architecture
135
182
136
183
```
@@ -158,37 +205,31 @@ packages/
158
205
drivers/ Shared database drivers (10 warehouses)
159
206
dbt-tools/ dbt integration (TypeScript)
160
207
plugin/ Plugin system
161
-
sdk/js/JavaScript SDK
208
+
sdk/ SDKs (includes VS Code extension)
162
209
util/ Shared utilities
163
210
```
164
211
165
-
## Documentation
166
-
167
-
Full docs at **[altimate.ai](https://altimate.ai)**.
- **Slack**: [altimate.ai/slack](https://altimate.ai/slack) — Real-time chat for questions, showcases, and feature discussion
215
+
- **Issues**: [GitHub Issues](https://github.com/AltimateAI/altimate-code/issues) — Bug reports and feature requests
216
+
- **Discussions**: [GitHub Discussions](https://github.com/AltimateAI/altimate-code/discussions) — Long-form questions and proposals
217
+
- **Security**: See [SECURITY.md](./SECURITY.md) for responsible disclosure
179
218
180
-
Contributions welcome! Please read the [Contributing Guide](./CONTRIBUTING.md) before opening a PR.
219
+
Contributions welcome — docs, SQL rules, warehouse connectors, and TUI improvements are all needed. The contributing guide covers setup, the vouch system, and the issue-first PR policy.
altimate is a fork of [OpenCode](https://github.com/anomalyco/opencode), the open-source AI coding agent. We build on top of their excellent foundation to add data-team-specific capabilities.
- **v0.4.0** (Feb 2026) — data visualization skill, 99+ tools, training system
227
+
- **v0.3.x** — [See full changelog →](CHANGELOG.md)
191
228
192
229
## License
193
230
194
231
MIT — see [LICENSE](./LICENSE).
232
+
233
+
## Acknowledgements
234
+
235
+
altimate is a fork of [OpenCode](https://github.com/anomalyco/opencode), the open-source AI coding agent. We build on top of their excellent foundation to add data-team-specific capabilities.
@@ -54,7 +51,11 @@ Skills are loaded from these locations (in priority order):
54
51
}
55
52
```
56
53
57
-
4. **Remote URLs** (from config):
54
+
4. **External directories & remote URLs** (if not disabled):
55
+
- `~/.claude/skills/`
56
+
- `~/.agents/skills/`
57
+
- `.claude/skills/` (project, searched up tree)
58
+
- `.agents/skills/` (project, searched up tree)
58
59
59
60
```json
60
61
{
@@ -66,13 +67,9 @@ Skills are loaded from these locations (in priority order):
66
67
67
68
## Built-in Data Engineering Skills
68
69
69
-
altimate includes skills for common data engineering tasks:
70
+
altimate ships with built-in skills for common data engineering tasks. Skills are loaded and surfaced dynamically at runtime — type `/` in the TUI to browse what's available and get autocomplete on skill names.
70
71
71
-
- SQL analysis and optimization
72
-
- dbt model generation
73
-
- Schema exploration
74
-
- Cost estimation
75
-
- Migration planning
72
+
For custom skills, see [Adding Custom Skills](#adding-custom-skills) below.
0 commit comments