forge docs

Kotlin Guide

Use the Kotlin SDK for Android and JVM Forge applications.

Kotlin Guide

The Kotlin SDK targets Android and JVM-based agent applications.

Primary surfaces

  • forge-kt/forge-core
  • forge-kt/forge-agent
  • forge-kt/forge-identity
  • forge-kt/forge-auth
  • forge-kt/forge-mcp

Choose Kotlin when

  • you need Android-native or JVM-native agent applications
  • your service or client stack is Kotlin-first
  • you want strong typed runtime behavior on the JVM

Use Kotlin when you need

  • Android-native agent experiences
  • JVM service integration with Forge concepts
  • strong typed runtime behavior in Kotlin ecosystems

Baseline developer workflow

  1. start in forge-kt
  2. validate the Gradle-based package tests and conformance harness
  3. keep runtime assumptions anchored to the repo release gate, not to partial implementation presence

Useful verification commands

  • ./gradlew test
  • python3 tools/release_gate.py --root .

Current guidance

Kotlin must satisfy the same release-gate and parity expectations as every other SDK. Language-specific tooling differences do not change the contract.