mirror of
https://github.com/Kaelio/ktx.git
synced 2026-06-07 07:55:13 +02:00
92 lines
3.6 KiB
Text
92 lines
3.6 KiB
Text
---
|
|
title: Introduction
|
|
description: How KTX gives analytics agents trusted context for warehouse work.
|
|
---
|
|
|
|
<div className="not-prose mb-14">
|
|
<div className="mb-8">
|
|
<h1
|
|
className="text-4xl font-extrabold tracking-tight lg:text-5xl"
|
|
style={{
|
|
fontFamily: 'var(--font-display)',
|
|
background: 'linear-gradient(180deg, var(--color-fd-foreground) 0%, color-mix(in oklch, var(--color-fd-foreground) 75%, var(--color-fd-primary)) 100%)',
|
|
WebkitBackgroundClip: 'text',
|
|
backgroundClip: 'text',
|
|
color: 'transparent',
|
|
WebkitTextFillColor: 'transparent',
|
|
lineHeight: '1.1',
|
|
letterSpacing: '0',
|
|
}}
|
|
>
|
|
Make analytics context{'\n'}usable by agents
|
|
</h1>
|
|
<p className="mt-4 text-lg text-fd-muted-foreground max-w-2xl" style={{ lineHeight: '1.7' }}>
|
|
KTX turns warehouse metadata, semantic definitions, and business knowledge
|
|
into reviewable project files that agents can use while planning, querying,
|
|
and updating analytics work.
|
|
</p>
|
|
</div>
|
|
<div className="flex flex-wrap gap-3">
|
|
<a
|
|
href="/docs/getting-started/quickstart"
|
|
className="inline-flex h-10 items-center rounded-lg bg-fd-primary px-5 text-sm font-medium text-fd-primary-foreground transition-colors hover:opacity-90"
|
|
>
|
|
Get Started
|
|
</a>
|
|
<a
|
|
href="/docs/concepts/the-context-layer"
|
|
className="inline-flex h-10 items-center rounded-lg border border-fd-border bg-fd-background px-5 text-sm font-medium text-fd-foreground transition-colors hover:bg-fd-muted"
|
|
>
|
|
The Context Layer
|
|
</a>
|
|
<a
|
|
href="/docs/guides/building-context"
|
|
className="inline-flex h-10 items-center rounded-lg border border-fd-border bg-fd-background px-5 text-sm font-medium text-fd-foreground transition-colors hover:bg-fd-muted"
|
|
>
|
|
Building Context
|
|
</a>
|
|
</div>
|
|
</div>
|
|
|
|
## Who KTX is for
|
|
|
|
KTX is built for analytics engineers and data teams who want data agents to
|
|
work on real analytics systems — not just generate one-off SQL.
|
|
|
|
Use KTX when you want agents to:
|
|
|
|
- **Generate SQL** from approved measures and joins
|
|
- **Repair semantic definitions** through reviewable diffs
|
|
- **Explain metric provenance** with warehouse evidence
|
|
- **Work alongside** dbt, LookML, MetricFlow, Looker, Metabase, and modern BI platforms
|
|
|
|
Works with PostgreSQL, Snowflake, BigQuery, ClickHouse, MySQL, and SQL Server.
|
|
|
|
## Explore the docs
|
|
|
|
<Cards>
|
|
<Card title="Quickstart" href="/docs/getting-started/quickstart">
|
|
Set up KTX and build your first context in under 10 minutes.
|
|
</Card>
|
|
<Card title="Concepts" href="/docs/concepts/the-context-layer">
|
|
Understand what a context layer is and why agents need one.
|
|
</Card>
|
|
<Card title="Guides" href="/docs/guides/building-context">
|
|
Hands-on workflows for scanning, ingesting, writing, and serving.
|
|
</Card>
|
|
<Card title="CLI Reference" href="/docs/cli-reference/ktx-setup">
|
|
Complete flag and subcommand reference for every KTX command.
|
|
</Card>
|
|
</Cards>
|
|
|
|
## Agent usage notes
|
|
|
|
| Agent task | Read next |
|
|
|------------|-----------|
|
|
| Discover machine-readable docs | [AI Resources](/docs/ai-resources) |
|
|
| Learn how a coding assistant should approach KTX | [Agent Quickstart](/docs/ai-resources/agent-quickstart) |
|
|
| Set up a new KTX project | [Quickstart](/docs/getting-started/quickstart) |
|
|
| Explain what problem KTX solves | [The Context Layer](/docs/concepts/the-context-layer) |
|
|
| Scan a database and ingest metadata | [Building Context](/docs/guides/building-context) |
|
|
| Edit semantic sources or knowledge pages | [Writing Context](/docs/guides/writing-context) |
|
|
| Look up exact command flags | [CLI Reference](/docs/cli-reference/ktx-setup) |
|