Repository + Application Map
How Athena is split across repos, crates, SDKs, applications, and supporting tooling.
Athena is not one repo or one runtime. This page is the top-level map for the current workspace and related repos so people can answer two questions quickly:
- Which repo owns this surface?
- Where is the deepest documentation for it right now?
Core Repos
| Repo | Main ownership | Deep docs in this site |
|---|---|---|
xylex-group/athena | Gateway server, Rust SDK/driver, workspace apps, operations crates | Platform, API, Cluster Operations, Athena RS SDK |
xylex-group/athena-auth | Athena authentication framework and core auth crates | Athena Auth Core, Plugins, Concepts, Integrations, OpenAPI |
xylex-group/athena-auth-ui | Prebuilt auth UI implementation and packaged HeroUI surface | Athena Auth UI SDK |
xylex-group/athena-js | TypeScript/JavaScript SDK for Athena gateway and Athena Auth | Athena.js SDK |
xylex-group/athena-mcp | MCP proxy for Athena gateway operations | MCP Overview |
xylex-group/better-auth-athena | Better Auth database adapter for Athena | Repo map only in this site today |
xylex-group/athena-operator | Kubernetes operator for Athena Gateway | Athena Operator |
xylex-group/athena-vscode-extension | IDE extension for executing queries and browsing data | Repo map only in this site today |
xylex-group/athena
Repository: github.com/xylex-group/athena
Workspace crates
| Target | Role | Current docs coverage |
|---|---|---|
athena_rs | Athena driver, gateway API server, and Rust SDK surface | Platform, API, Athena RS SDK |
athena-actix | Shared Actix request-context wrappers, header extractors, wildcard host routing, and best-effort runtime spawn helpers | Athena Actix Crate, API |
athena-control-plane | Durable control-plane state, clone job repositories, lease and event contracts | Cluster Operations, Platform Daemon Runtime |
athena-clone | Postgres snapshot clone planning, execution, verification, and registration seams | Cluster Clone Jobs, Platform Daemon Runtime |
athena-daemon | Dedicated daemon runtime for durable clone jobs and migrated workers | Platform Daemon Runtime, Cluster Operations |
athena-client-pressure | Client-pressure scoring, snapshot persistence helpers, admin read models, and the background sweep worker loop | Athena Client Pressure Crate, Admin + Management APIs |
athena-cdc | Portable change-data-capture helpers, Sequin replay, state tracking, and CDC audit payload builders | Athena CDC Crate, Pipelines + Realtime |
athena-driver | Backend driver primitives, including Scylla execution, Supabase health-aware clients, and portable PostgreSQL helper modules | Athena Driver Crate, Platform |
athena-wss | Websocket gateway contract helpers plus CDC websocket broadcast, replay, and transport server code | Athena WSS Crate, Pipelines + Realtime |
athena-gateway | Portable gateway contracts, structured-fetch parsing plus SQL compilation/execution, deferred payloads, schema/table normalization, fetch body preprocessing, legacy GET /data compatibility planning, /gateway/query plus /gateway/update plus /gateway/delete request planning, delete resource-ID lookup planning, fetch singleflight coordination, gateway resource-ID fallback resolution heuristics, metadata-aware fetch condition helpers, PostgREST compatibility parsing, RPC compatibility parsing, and gateway right helpers | Athena Gateway Crate, API |
athena-observability | Shared metrics state, route classification, gateway log contracts, client-stat batching, and Linux NDJSON sinks | Athena Observability Crate, Architecture Guides |
athena-query | Reusable query builders, Postgres type coercion helpers, optimization workflows, and dialect metadata for SQL/CQL evolution | Athena Query Crate, API |
athena-pipelines | Portable pipeline definitions, YAML template parsing, request merging, and gateway-fetch body builders | Athena Pipelines Crate, Pipelines + Realtime |
athena-provisioning | Provisioning and environment bootstrap workflows | Admin + Management APIs, Cluster Operations |
athena-scheduler | Scheduled-job execution and timed orchestration | Cluster Operations |
athena-schema-heal | Schema drift repair and healing workflows | Schema Introspection |
athena-typesense | Optional Typesense sync, search proxy, and background worker-domain logic | Athena Typesense Crate, Typesense Search + Sync |
athena-worker | Background worker runtime for async or operational jobs | Pipelines + Realtime |
Workspace applications
| Path / app | Role | Current docs coverage |
|---|---|---|
apps/cloudflare-athena / athena-cloudflare-wrangler | Containerized Wrangler wrapper around the Athena server | Repo map only in this site today |
apps/desktop / athena-desktop | Tauri desktop implementation with auxiliary tooling built from Athena Studio | Repo map only in this site today |
apps/docs / athena-docs | Documentation website | You are here |
apps/marketing / athena-marketing | Landing page website | Repo map only in this site today |
apps/web / athena-studio | Studio database explorer frontend | Repo map only in this site today |
apps/web / athena-wss-gateway | WSS gateway proxy that interfaces the local gateway API | Repo map only in this site today |
xylex-group/athena-auth
Repository: github.com/xylex-group/athena-auth
| Target | Role | Current docs coverage |
|---|---|---|
athena-auth | Root auth framework and public auth runtime | Athena Auth Core, OpenAPI |
athena-auth-api, athena-auth-core, athena-auth-derive, athena-auth-multitenancy, athena-auth-observability | Core crates that implement the framework, macros, multitenancy, and observability seams | Athena Auth Core, Concepts, Plugins, Integrations |
apps/demo / athena-auth-demo | Demo application for Athena Auth flows | Repo map only in this site today |
xylex-group/athena-auth-ui
Repository: github.com/xylex-group/athena-auth-ui
| Target | Role | Current docs coverage |
|---|---|---|
athena-auth-ui | Native UI implementation for Athena Auth | Athena Auth UI SDK |
examples/heroui | Example application for the packaged UI surface | Athena Auth UI SDK |
packages/heroui | Main packaged HeroUI component surface | Athena Auth UI SDK |
xylex-group/athena-js
Repository: github.com/xylex-group/athena-js
| Target | Role | Current docs coverage |
|---|---|---|
athena-js | TypeScript and JavaScript SDK for athena_rs gateway flows and Athena Auth flows | Athena.js SDK |
xylex-group/athena-mcp
Repository: github.com/xylex-group/athena-mcp
| Target | Role | Current docs coverage |
|---|---|---|
athena-mcp | MCP proxy for the Athena gateway server | MCP Overview |
Supporting Adapters, Operators, And Tools
| Repo | Role | Current docs coverage |
|---|---|---|
xylex-group/better-auth-athena | Better Auth adapter backed by Athena | Repo map only in this site today |
xylex-group/athena-operator | Kubernetes operator for Athena Gateway deployments | Athena Operator |
xylex-group/athena-vscode-extension | VS Code extension for query execution and data inspection in the IDE | Repo map only in this site today |
How To Use This Map
- Start here when you know the repo or app name, but not the matching docs section.
- Use SDK Overview when you already know you need a client/package surface rather than a workspace map.
- Use Documentation Status when you want to see broader coverage gaps and reference generation state.