wiretapKMP

1.0.0-RC15indexed

Intercept HTTP and WebSocket traffic, mock API responses, throttle requests, and capture detailed logs; includes built-in inspector UI, header masking, log retention, and no-op release variants.

AndroidJVMNative·skymansandy/wiretapKMP

Stars

—

Used by

dependents

Health

/ 100

WiretapKMP — Powerful, Cross-Platform Network Inspection for Kotlin Multiplatform

WiretapKMP is a drop-in network inspector and mocker for Kotlin Multiplatform apps. Add one dependency, install the plugin, and inspect every HTTP request, WebSocket message, and SSE event — or mock and throttle them — all from a built-in UI. No proxy needed.

Early Preview — We're looking for early adopters and feedback! Open an issue or start a discussion.

🚀 Quick Start

// Ktor
val client = HttpClient {
    install(WiretapKtorHttpPlugin)
}

// OkHttp
val client = OkHttpClient.Builder()
    .addInterceptor(WiretapOkHttpInterceptor())
    .build()

That's it. Open your app and shake the device (or press Ctrl+Shift+D on desktop) to launch the inspector.

✅ What You Get

📸 Screenshots

Overview	Request	Response

WebSocket	Messages	Notifications

⭐ Key Features

More screenshots

API Mocking & Rules Engine

📡 SSE Inspection (Experimental)

WiretapKMP can inspect Server-Sent Events (SSE) streams — log every connection, event, and status change right alongside your HTTP and WebSocket traffic.

⚠️ SSE inspection is in early preview. APIs are marked with @ExperimentalWiretapSseApi and may change in future releases.

Ktor

Install the SSE plugin — sessions are wrapped automatically:

@OptIn(ExperimentalWiretapSseApi::class)
val client = HttpClient {
    install(SSE)
    install(WiretapKtorSsePlugin)    // SSE logging
    install(WiretapKtorHttpPlugin)   // HTTP logging
}

client.sse("https://api.example.com/stream") {
    incoming.collect { event ->
        println("Event: ${event.event} — ${event.data}")
    }
}

OkHttp

Wrap your EventSourceListener with .wiretapped():

val client = OkHttpClient.Builder()
    .addInterceptor(WiretapOkHttpInterceptor())
    .build()

val request = Request.Builder().url("https://api.example.com/stream").build()
val factory = EventSources.createFactory(client)

@OptIn(ExperimentalWiretapSseApi::class)
factory.newEventSource(request, myListener.wiretapped())

What Gets Logged

Connection	Events
URL, headers, status (Open → Closed/Failed), timestamps	Event type, data payload, event ID, byte count, timestamp

For full details, see the Ktor SSE guide and OkHttp SSE guide.

📦 Installation

// build.gradle.kts
debugImplementation("dev.skymansandy:wiretap-ktor:1.0.0-RC15")
releaseImplementation("dev.skymansandy:wiretap-ktor-noop:1.0.0-RC15")

// or for OkHttp
debugImplementation("dev.skymansandy:wiretap-okhttp:1.0.0-RC15")
releaseImplementation("dev.skymansandy:wiretap-okhttp-noop:1.0.0-RC15")

For full setup including URLSession and advanced configuration, see the Getting Started guide.