Turns Ktor HTTP requests into runnable curl commands for debugging and logging. Pure Kotlin, works on Android, iOS, and JVM (KMP).

Inspired by Ok2Curl for OkHttp.

• Zero-config install: add the plugin, done
• Mask sensitive headers (tokens, API keys) before they hit your logs
• Exclude noisy headers entirely
• Correct multipart/form-data and file-upload rendering
• Bring your own logger: console, Logcat, remote sink, anything

Kotlin 2.3+, Ktor 3.5+, Gradle 7.0+.

dependencies {
    implementation("io.github.kabirnayeem99:ktor2curl:3.0.1")
}

Same snippet for KMP (commonMain) and Android-only projects.

val client = HttpClient(CIO) {
    install(KtorToCurl) {
        logger = CurlLogger.console() // or Log.d(), a file sink, anything
    }
}

client.post("https://api.example.com/users") {
    headers.append(HttpHeaders.Authorization, "Bearer YOUR_TOKEN")
    contentType(ContentType.Application.Json)
    setBody("""{"name":"Alice"}""")
}

curl -H 'Authorization: Bearer YOUR_TOKEN' -H 'Content-Type: application/json' 'https://api.example.com/users' --data-binary '{"name":"Alice"}'

install(KtorToCurl) {
    logger = CurlLogger.console()
    maskedHeaders = setOf(HttpHeaders.Authorization, "X-API-Key")
    excludedHeaders = setOf(HttpHeaders.UserAgent) // dropped entirely, not just masked
}

curl -H 'Authorization: [masked]' -H 'Content-Type: application/json' 'https://api.example.com/users' --data-binary '{"name":"Alice"}'

Full reference with a runnable example per option (timeouts, retries, truncation, shell dialect, custom logger, multipart, and more): docs/API.md.

• Dependency won't resolve: make sure mavenCentral() is in repositories {} and Kotlin is 2.3+.
• Nothing gets logged: confirm logger is set, the plugin is installed before any requests are made, and the request actually completes (failed requests may not reach the send pipeline).
• A header isn't masked: header names match case-insensitively, but check for typos; prefer HttpHeaders.* constants over string literals.
• iOS build fails: Kotlin must be 2.3.0+ (older versions can't consume Ktor 3.5's Darwin klib ABI).

See CONTRIBUTING.md.

Ktor docs | Issues | Discussions

MIT. See LICENSE.