# Athena RS 3.25.0
current version: `3.26.3`
## Athena
Athena is the Rust gateway and runtime (core binary: `athena_rs`).
- `athena_rs` — the runtime, server, and library surfaces.
- `athena` — the CLI / toolchain that interfaces the `athena_rs` runtime and the APIs.
The `athena` CLI is the recommended way to interact with Athena (clients, SQL, pipelines, audit, provisioning, etc.). Just run `athena` with no arguments for a friendly guide.
### Start here
- [Docs hub](docs/README.md)
- [Workspace scale](docs/workspace-scale.md)
- [Workspace manifest](docs/workspace-manifest.md)
- [CLI manifest](docs/cli-manifest.md)
- [Crates overview](crates/README.md) and [crate manifest](crates/MANIFEST.md)
- [Apps overview](apps/README.md) and [app manifest](apps/MANIFEST.md)
- [Benches overview](benches/README.md) and [bench manifest](benches/MANIFEST.md)
- [Examples overview](examples/README.md) and [example manifest](examples/MANIFEST.md)
### Repository shape
- `src/` holds the root `athena_rs` server/runtime and the Rust SDK surface.
- `crates/` contains 29 package directories, including 28 root-workspace members and 1 adjacent crate.
- `apps/` contains 8 operator, docs, desktop, marketing, and edge-delivery surfaces.
- `sql/` contains runnable provision and migration SQL.
- `docs/` contains repo-local architecture, runtime, and workspace documentation.
- `openapi.yaml` and `openapi-wss.yaml` capture the HTTP and WebSocket contracts.
### Common workflows
- Inspect the runtime CLI from the repo root with `cargo run --bin athena -- --help` (or `athena --help` after building).
- Run Rust tests and heavier Rust verification from WSL2 on this machine rather than the Windows toolchain.
- Use the folder READMEs when changing one surface; use the MANIFEST files when you need the whole workspace map.
### Deep reference
- [Architecture and repo docs](docs/README.md)
- [Route inventory](routes.md)
- [HTTP OpenAPI](openapi.yaml)
- [WebSocket OpenAPI](openapi-wss.yaml)
- [Product docs app content](apps/docs/content/docs)