# google/ksp architecture

> Architecture diagram of the GitHub repository google/ksp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/google/ksp
- Repository: https://github.com/google/ksp

## Overview

KSP is a Kotlin compiler-plugin API and runtime for annotation-driven symbol processing. The main workflow is that a Gradle or command-line compilation starts KSP, processors query a resolver over source symbols, and the code generator writes outputs for compilation. The graph also includes the documented incremental-processing capability and the distinct Gradle and command-line entry points. The tree and excerpts establish these modules and responsibilities, but do not expose all runtime wiring, so uncertain internal calls are omitted.

Main entry points: [`kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/KotlinSymbolProcessing.kt`](https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/KotlinSymbolProcessing.kt) (KSP engine), [`api/src/main/kotlin/com/google/devtools/ksp/processing/SymbolProcessor.kt`](https://github.com/google/ksp/blob/main/api/src/main/kotlin/com/google/devtools/ksp/processing/SymbolProcessor.kt) (Processor API), [`kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/ResolverAAImpl.kt`](https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/ResolverAAImpl.kt) (Resolver), [`kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/symbol/kotlin/KSClassDeclarationImpl.kt`](https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/symbol/kotlin/KSClassDeclarationImpl.kt) (Symbol implementations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["Build integration"]
  node_gradle_plugin["Gradle plugin<br/>[KspSubplugin.kt]"]
  node_cli_entry["CLI entry points"]
end

subgraph group_runtime["Processing runtime"]
  node_processing_api["Processor API<br/>[SymbolProcessor.kt]"]
  node_symbol_api["Symbol model<br/>[KSNode.kt]"]
  node_ksp_core["KSP engine"]
  node_resolver["Resolver<br/>[ResolverAAImpl.kt]"]
end

subgraph group_analysis["Symbol analysis"]
  node_psi_resolution["PSI resolution"]
  node_aa_resolution["Analysis API"]
  node_symbol_impl["Symbol implementations"]
end

subgraph group_outputs["Outputs and incrementality"]
  node_codegen["Code generation"]
  node_incremental["Incremental tracking"]
  node_generated["Generated sources"]
end

node_developer(("Processor author"))
node_gradle(("Gradle build"))
node_cli(("CLI invocation"))
node_compiler(("Kotlin compilation"))

node_developer -->|"implements"| node_processing_api
node_gradle -->|"applies"| node_gradle_plugin
node_cli -->|"starts"| node_cli_entry
node_gradle_plugin -->|"starts processing"| node_ksp_core
node_cli_entry -->|"starts processing"| node_ksp_core
node_ksp_core -->|"provides"| node_resolver
node_resolver -->|"exposes symbols"| node_symbol_impl
node_psi_resolution -->|"builds symbols"| node_symbol_impl
node_aa_resolution -->|"builds symbols"| node_symbol_impl
node_processing_api -->|"queries"| node_resolver
node_processing_api -->|"writes through"| node_codegen
node_codegen -->|"writes"| node_generated
node_ksp_core -->|"tracks changes"| node_incremental
node_generated -->|"compiles"| node_compiler

click node_gradle_plugin "https://github.com/google/ksp/blob/main/gradle-plugin/src/main/kotlin/com/google/devtools/ksp/gradle/KspSubplugin.kt"
click node_cli_entry "https://github.com/google/ksp/tree/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/cmdline"
click node_processing_api "https://github.com/google/ksp/blob/main/api/src/main/kotlin/com/google/devtools/ksp/processing/SymbolProcessor.kt"
click node_symbol_api "https://github.com/google/ksp/blob/main/api/src/main/kotlin/com/google/devtools/ksp/symbol/KSNode.kt"
click node_ksp_core "https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/KotlinSymbolProcessing.kt"
click node_resolver "https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/ResolverAAImpl.kt"
click node_psi_resolution "https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/common/impl/PsiResolutionStrategy.kt"
click node_aa_resolution "https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/common/impl/AAResolutionStrategy.kt"
click node_symbol_impl "https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/symbol/kotlin/KSClassDeclarationImpl.kt"
click node_codegen "https://github.com/google/ksp/blob/main/common-util/src/main/kotlin/com/google/devtools/ksp/common/impl/CodeGeneratorImpl.kt"
click node_incremental "https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/IncrementalContextAA.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gradle_plugin,node_cli_entry toneBlue
class node_processing_api,node_symbol_api,node_ksp_core,node_resolver toneAmber
class node_psi_resolution,node_aa_resolution,node_symbol_impl toneMint
class node_codegen,node_incremental,node_generated toneRose
class node_developer,node_gradle,node_cli,node_compiler toneIndigo
```

## Components

### Build integration

- [Gradle plugin](https://github.com/google/ksp/blob/main/gradle-plugin/src/main/kotlin/com/google/devtools/ksp/gradle/KspSubplugin.kt): `gradle-plugin/src/main/kotlin/com/google/devtools/ksp/gradle/KspSubplugin.kt`
- [CLI entry points](https://github.com/google/ksp/tree/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/cmdline): `kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/cmdline`

### Processing runtime

- [Processor API](https://github.com/google/ksp/blob/main/api/src/main/kotlin/com/google/devtools/ksp/processing/SymbolProcessor.kt): `api/src/main/kotlin/com/google/devtools/ksp/processing/SymbolProcessor.kt`
- [Symbol model](https://github.com/google/ksp/blob/main/api/src/main/kotlin/com/google/devtools/ksp/symbol/KSNode.kt): `api/src/main/kotlin/com/google/devtools/ksp/symbol/KSNode.kt`
- [KSP engine](https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/KotlinSymbolProcessing.kt): `kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/KotlinSymbolProcessing.kt`
- [Resolver](https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/ResolverAAImpl.kt): `kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/ResolverAAImpl.kt`

### Symbol analysis

- [PSI resolution](https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/common/impl/PsiResolutionStrategy.kt): `kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/common/impl/PsiResolutionStrategy.kt`
- [Analysis API](https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/common/impl/AAResolutionStrategy.kt): `kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/common/impl/AAResolutionStrategy.kt`
- [Symbol implementations](https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/symbol/kotlin/KSClassDeclarationImpl.kt): `kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/symbol/kotlin/KSClassDeclarationImpl.kt`

### Outputs and incrementality

- [Code generation](https://github.com/google/ksp/blob/main/common-util/src/main/kotlin/com/google/devtools/ksp/common/impl/CodeGeneratorImpl.kt): `common-util/src/main/kotlin/com/google/devtools/ksp/common/impl/CodeGeneratorImpl.kt`
- [Incremental tracking](https://github.com/google/ksp/blob/main/kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/IncrementalContextAA.kt): `kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/IncrementalContextAA.kt`
- **Generated sources**

### Other components

- **Processor author**
- **Gradle build**
- **CLI invocation**
- **Kotlin compilation**

## Connections

- Processor author → Processor API: implements
- Gradle build → Gradle plugin: applies
- CLI invocation → CLI entry points: starts
- Gradle plugin → KSP engine: starts processing
- CLI entry points → KSP engine: starts processing
- KSP engine → Resolver: provides
- Resolver → Symbol implementations: exposes symbols
- PSI resolution → Symbol implementations: builds symbols
- Analysis API → Symbol implementations: builds symbols
- Processor API → Resolver: queries
- Processor API → Code generation: writes through
- Code generation → Generated sources: writes
- KSP engine → Incremental tracking: tracks changes
- Generated sources → Kotlin compilation: compiles
