Repo brief: kysely-org/kysely

Generated by RepoPilot · document generated 2026-09-15 · concise human review Evidence snapshot · analyzed 2026-09-15T08:22:57.788Z · commit d872cf0e74d8

Verdict

Healthy — Healthy across all four use cases

• Last commit today
• 9 active contributors
• MIT licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

Kysely is a type-safe TypeScript SQL query builder that compiles to SQL across PostgreSQL, MySQL, MSSQL, SQLite, and PGlite. It eliminates runtime SQL string errors by leveraging TypeScript's type system to validate queries at compile time, allowing developers to write database queries as chainable method calls with full IDE autocomplete and type checking. Monolithic library structure with dialect separation: src/dialect/{postgres,mysql,mssql,sqlite,pglite} each contain adapter, dialect config, driver, introspector, and query-compiler implementations. Core abstractions live in src/driver (connection pooling, connection providers), src/expression (query DSL), and src/dynamic (runtime…

Start here

Open these first:

• src/kysely.ts — Main Kysely class entry point that orchestrates query building, dialect handling, and database operations.
• src/dialect/dialect.ts — Abstract dialect interface that defines how different databases (PostgreSQL, MySQL, SQLite, MSSQL) integrate their SQL…
• src/operation-node/operation-node.ts — Core AST node abstraction used throughout the codebase to represent SQL query components.
• src/expression/expression-builder.ts — Expression builder establishes the fluent API contract for constructing WHERE clauses, joins, and other SQL expressions.
• src/driver/driver.ts — Driver interface abstracts database connection pooling, query execution, and connection lifecycle management.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Clone: git clone https://github.com/kysely-org/kysely.git && cd kysely. Install: pnpm install (package manager is pnpm, inferred from package.json scripts using pnpm). Build: pnpm clean && pnpm build (implied by t…

Daily commands:

Development: pnpm build compiles TypeScript to dist/. Testing: pnpm test runs mocha tests against test/node/dist/**/*.test.js. Browser testing: pnpm test:browser:build && node test/browser/test.js. Node tests spec…

…shortened for this brief.

Key cautions & unknowns

• Scorecard: known vulnerabilities detected (scored 0/10 by OpenSSF)
• Concentrated ownership — top contributor handles 54% of recent commits
• 1. Requires TypeScript 5.4+ for full type safety (see typesVersions fallback to outdated-typescript.d.ts); check your tsconfig version. 2) Node engine constraint: >=22.0.0 is modern and breaking for older projects. 3)…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.