[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82070":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":16,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":20,"hasPages":20,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":43,"readmeContent":44,"aiSummary":45,"trendingCount":16,"starSnapshotCount":16,"syncStatus":46,"lastSyncTime":47,"discoverSource":48},82070,"ktx-ai-data-agents-mcp-context-skills","Kaelio\u002Fktx-ai-data-agents-mcp-context-skills","Kaelio","ktx is an executable context layer for data and analytics agents 🐙 Allow Claude Code, Codex, and any AI agent to query data accurately through MCP with skills, memory and a semantic layer","https:\u002F\u002Fdocs.kaelio.com\u002Fktx",null,"TypeScript",663,38,1,14,0,175,8.77,"Apache License 2.0",false,"main",[23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42],"agent","agent-skills","agents","ai-agent","ai-agents","analytics","analytics-engineering","business-intelligence","claude","claude-code","claude-skills","codex","context-layer","data-analysis","data-engineering","llm","mcp","memory","semantic-layer","skills","2026-06-12 02:04:22","\u003Ch1 align=\"center\">\n  \u003Cimg src=\"assets\u002Fktx-lockup.svg\" alt=\"ktx\" width=\"500\" \u002F>\n\u003C\u002Fh1>\n\n\u003Ch1 align=\"center\">\n  The context layer for data agents\n\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@kaelio\u002Fktx\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@kaelio\u002Fktx?style=flat-square&color=f97316\" alt=\"npm version\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fcodecov.io\u002Fgh\u002FKaelio\u002Fktx\">\u003Cimg src=\"https:\u002F\u002Fcodecov.io\u002Fgh\u002FKaelio\u002Fktx\u002Fgraph\u002Fbadge.svg?branch=main\" alt=\"Codecov\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FKaelio\u002Fktx\u002Factions\u002Fworkflows\u002Fci.yml?query=branch%3Amain\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002FKaelio\u002Fktx\u002Fci.yml?branch=main&label=tests&style=flat-square\" alt=\"Tests\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdocs.kaelio.com\u002Fktx\u002Fdocs\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdocs-ktx-22c55e?style=flat-square\" alt=\"Documentation\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fjoin.slack.com\u002Ft\u002Fktxcommunity\u002Fshared_invite\u002Fzt-3y9b44m1x-LVyNNJD5nwaZHq4XS29LMQ\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fslack-join%20community-4A154B?style=flat-square&logo=slack&logoColor=white\" alt=\"Join the ktx Slack community\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FKaelio\u002Fktx\u002Fblob\u002Fmain\u002FLICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-Apache%202.0-blue?style=flat-square\" alt=\"License\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.ycombinator.com\u002Fcompanies?batch=P25\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FY%20Combinator-P25-orange?style=flat-square\" alt=\"Y Combinator P25\" \u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fdocs.kaelio.com\u002Fktx\u002Fdocs\u002Fgetting-started\u002Fquickstart\">\u003Cb>Quickstart\u003C\u002Fb>\u003C\u002Fa> ·\n  \u003Ca href=\"https:\u002F\u002Fdocs.kaelio.com\u002Fktx\u002Fdocs\u002Fcli-reference\u002Fktx\">\u003Cb>CLI Reference\u003C\u002Fb>\u003C\u002Fa> ·\n  \u003Ca href=\"https:\u002F\u002Fdocs.kaelio.com\u002Fktx\u002Fdocs\u002Fai-resources\u002Fagent-quickstart\">\u003Cb>Agent Setup\u003C\u002Fb>\u003C\u002Fa> ·\n  \u003Ca href=\"https:\u002F\u002Fjoin.slack.com\u002Ft\u002Fktxcommunity\u002Fshared_invite\u002Fzt-3y9b44m1x-LVyNNJD5nwaZHq4XS29LMQ\">\u003Cb>Slack\u003C\u002Fb>\u003C\u002Fa>\n\u003C\u002Fp>\n\n---\n\n**ktx** is a self-improving context layer that teaches agents how to query your\nwarehouse accurately - from approved metric definitions, joinable columns, and\nbusiness knowledge it builds and maintains for you.\n\n> [!NOTE]\n> Run **ktx** with your own LLM API keys or a **Claude Pro\u002FMax** subscription.\n> No extra usage billing from **ktx**.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs-site\u002Fpublic\u002Fimages\u002Fingestion-flow-transparent.svg\" alt=\"ktx ingestion flow from source systems through validation to wiki and semantic-layer outputs\" width=\"900\" \u002F>\n\u003C\u002Fp>\n\n## Why ktx\n\nGeneral-purpose agents struggle on data tasks. They re-explore your warehouse\non every question, invent their own metric logic, and return numbers that\ndon't match approved definitions.\n\nTraditional semantic layers don't fix this. They demand constant manual\nupkeep and don't absorb the rest of your company's knowledge.\n\n**ktx** does both, automatically:\n\n- **Learns from company knowledge.** Ingests wiki content, organizes it,\n  removes duplicates, and flags contradictions for human review.\n- **Maps the data stack.** Samples tables, captures metadata and usage\n  patterns, detects joinable columns, and annotates sources so agents write\n  better queries.\n- **Builds a semantic layer.** Combines raw tables and high-level metrics\n  through a join graph that automatically resolves chasm and fan traps, so\n  agents fetch metrics declaratively instead of rewriting canonical SQL each\n  time.\n- **Serves agents at execution.** Exposes CLI and MCP tools with combined\n  full-text and semantic search across wiki and semantic-layer entities.\n\n## How ktx compares\n\n|  | General-purpose agent | Traditional semantic layer | **ktx** |\n| --- | :---: | :---: | :---: |\n| Builds warehouse context automatically | — | — | ✓ |\n| Detects joinable columns + resolves fan\u002Fchasm traps | — | Manual | ✓ |\n| Approved, reusable metric definitions | — | ✓ | ✓ |\n| Absorbs wiki \u002F Notion \u002F team knowledge | — | — | ✓ |\n| Flags contradictions across sources | — | — | ✓ |\n| Ships CLI + MCP for agent execution | Partial | — | ✓ |\n| Read-only by design | n\u002Fa | n\u002Fa | ✓ |\n\n## Who is ktx for\n\n**Use ktx if you:**\n\n- Want agents like Claude Code, Codex, Cursor, or OpenCode to query your\n  warehouse with approved metric definitions\n- Have business knowledge scattered across dbt, Looker, Metabase, Notion, and\n  team wikis\n- Need agents to reuse canonical SQL instead of inventing it on every prompt\n\n**Skip ktx if you:**\n\n- You don't have a SQL warehouse - **ktx** sits on top of one\n- You only need one ad-hoc query - `psql` or a notebook will do\n\nWorks with PostgreSQL, Snowflake, BigQuery, ClickHouse, MySQL, SQL Server, and\nSQLite. Integrates with dbt, MetricFlow, LookML, Looker, Metabase, and Notion.\n\n## Quick Start\n\n```bash\nnpm install -g @kaelio\u002Fktx\nktx setup\nktx status\n```\n\n`ktx setup` creates or resumes a local **ktx** project, configures providers\nand connections, builds context, and installs agent integration.\n\nExample `ktx status` after setup:\n\n```text\nktx project: \u002Fhome\u002Fuser\u002Fanalytics\nProject ready: yes\nLLM ready: yes (claude-sonnet-4-6)\nEmbeddings ready: yes (text-embedding-3-small)\nDatabases configured: yes (warehouse)\nContext sources configured: yes (dbt_main)\nktx context built: yes\nAgent integration ready: yes (codex:project)\n```\n\n> [!TIP]\n> Already using an agent? Ask Claude Code, Codex, Cursor, or OpenCode from\n> your project directory:\n>\n> ```text\n> Run npx skills add Kaelio\u002Fktx --skill ktx and use the ktx skill to install\n> and configure ktx in this project.\n> ```\n\n> [!IMPORTANT]\n> If `ktx status` prints `ktx mcp start --project-dir ...`, run it before\n> opening your agent client.\n\n## First commands\n\n| Command | Purpose |\n| --- | --- |\n| `ktx setup` | Create, resume, or update a **ktx** project |\n| `ktx status` | Check project readiness |\n| `ktx ingest` | Build context for every configured connection |\n| `ktx sl \"revenue\"` | Search semantic sources |\n| `ktx wiki \"refund policy\"` | Search local wiki pages |\n| `ktx mcp start` | Start the MCP server for agent clients |\n\nSee the [CLI Reference](https:\u002F\u002Fdocs.kaelio.com\u002Fktx\u002Fdocs\u002Fcli-reference\u002Fktx)\nfor every command, flag, and option.\n\n## Project Layout\n\n```text\nmy-project\u002F\n├── ktx.yaml                         # Project configuration\n├── semantic-layer\u002F\u003Cconnection-id>\u002F  # YAML semantic sources\n├── wiki\u002Fglobal\u002F                     # Shared business context\n├── wiki\u002Fuser\u002F\u003Cuser-id>\u002F             # User-scoped notes\n├── raw-sources\u002F\u003Cconnection-id>\u002F     # Ingest artifacts and reports\n└── .ktx\u002F                            # Local state and secrets, git-ignored\n```\n\nCommit `ktx.yaml`, `semantic-layer\u002F`, and `wiki\u002F`. Keep `.ktx\u002F` local.\n\nProject resolution defaults to `KTX_PROJECT_DIR`, then the nearest `ktx.yaml`,\nthen the current directory. Pass `--project-dir \u003Cpath>` when scripting.\n\n## FAQ\n\n- **Does ktx send my schema or query results to a hosted service?**\n  No. **ktx** runs locally. The only data leaving your machine is what you\n  send to the LLM provider you configured.\n- **Which LLM backends are supported?**\n  Anthropic API, Google Vertex AI, AI Gateway, and the local Claude Code\n  session through the Claude Agent SDK. See\n  [LLM configuration](https:\u002F\u002Fdocs.kaelio.com\u002Fktx\u002Fdocs\u002Fguides\u002Fllm-configuration).\n- **How is ktx different from a dbt or MetricFlow semantic layer?**\n  **ktx** *ingests* those layers and combines them with raw-table\n  introspection and wiki content. Agents get one searchable surface instead\n  of three disconnected ones - and **ktx** flags contradictions across\n  sources.\n- **Does ktx need a running server?**\n  There is no hosted service. The local MCP daemon runs on demand via\n  `ktx mcp start` when an agent client needs it.\n- **Is my warehouse safe?**\n  Yes. Connections are read-only - **ktx** never writes to your database.\n\n## Docs\n\n- [Quickstart](https:\u002F\u002Fdocs.kaelio.com\u002Fktx\u002Fdocs\u002Fgetting-started\u002Fquickstart)\n- [The Context Layer](https:\u002F\u002Fdocs.kaelio.com\u002Fktx\u002Fdocs\u002Fconcepts\u002Fthe-context-layer)\n- [Building Context](https:\u002F\u002Fdocs.kaelio.com\u002Fktx\u002Fdocs\u002Fguides\u002Fbuilding-context)\n- [CLI Reference](https:\u002F\u002Fdocs.kaelio.com\u002Fktx\u002Fdocs\u002Fcli-reference\u002Fktx)\n- [Agent Quickstart](https:\u002F\u002Fdocs.kaelio.com\u002Fktx\u002Fdocs\u002Fai-resources\u002Fagent-quickstart)\n- [Community & Support](https:\u002F\u002Fdocs.kaelio.com\u002Fktx\u002Fdocs\u002Fcommunity\u002Fsupport)\n\n## Community\n\n- **[Slack](https:\u002F\u002Fjoin.slack.com\u002Ft\u002Fktxcommunity\u002Fshared_invite\u002Fzt-3y9b44m1x-LVyNNJD5nwaZHq4XS29LMQ)** — ask questions, share what you're building, and chat with maintainers.\n- **[GitHub Issues](https:\u002F\u002Fgithub.com\u002FKaelio\u002Fktx\u002Fissues)** — report bugs and request features.\n- **[Contributing](https:\u002F\u002Fdocs.kaelio.com\u002Fktx\u002Fdocs\u002Fcommunity\u002Fcontributing)** — set up the repo, run tests, and open a PR.\n\n## Development\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fkaelio\u002Fktx.git\ncd ktx\npnpm install\nuv sync --all-groups\npnpm run build\npnpm run check\n```\n\n**ktx** is a pnpm + uv workspace:\n\n| Path | Purpose |\n| --- | --- |\n| `packages\u002Fcli` | TypeScript CLI and published npm package source |\n| `packages\u002Fcli\u002Fsrc\u002Fcontext` | Core context engine |\n| `packages\u002Fcli\u002Fsrc\u002Fllm` | LLM and embedding providers |\n| `packages\u002Fcli\u002Fsrc\u002Fconnectors` | Database scan connectors |\n| `python\u002Fktx-sl` | Semantic-layer query planning |\n| `python\u002Fktx-daemon` | Portable compute service |\n\nLocal development CLI:\n\n```bash\npnpm run setup:dev\npnpm run link:dev\nktx-dev --help\n```\n\nUseful checks:\n\n```bash\npnpm run type-check\npnpm run test\npnpm run dead-code\nuv run pytest -q\n```\n\n## Telemetry\n\n**ktx** collects anonymous usage telemetry from interactive CLI runs to\nimprove setup, command reliability, and data-agent workflows. No file paths,\nhostnames, SQL, schema names, error messages, or argv are recorded. See\n[Telemetry](https:\u002F\u002Fdocs.kaelio.com\u002Fktx\u002Fdocs\u002Fcommunity\u002Ftelemetry) for the\nevent catalog and opt-out options.\n\n## License\n\n**ktx** is licensed under the Apache License, Version 2.0. See `LICENSE`.\n\n## Star History\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fstar-history.com\u002F#Kaelio\u002Fktx&Date\">\n    \u003Cimg src=\"assets\u002Fstar-history.svg\" alt=\"ktx Star History Chart\" width=\"700\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n","ktx 是一个可执行的上下文层，旨在帮助数据和分析代理（如Claude Code、Codex等AI代理）通过MCP准确查询数据。该项目使用TypeScript开发，具有技能管理和记忆功能，能够自动学习公司知识并映射数据栈，从而确保查询结果符合已批准的度量定义和业务逻辑。适合需要提高数据分析准确性及效率的企业或团队使用，特别是在构建基于AI的数据分析解决方案时。",2,"2026-06-01 03:57:12","CREATED_QUERY"]