Skip to content

What is JetWhale? ​

JetWhale is an extensible debugging tool inspired by Flipper, built with Kotlin and Jetpack Compose for Kotlin Multiplatform apps: Android, desktop (JVM), iOS and the web.

The JetWhale host window: the sidebar with Sample App connected from a Pixel 9 emulator and its plugins, and the Network Inspector showing the app's HTTP trafficThe JetWhale host window: the sidebar with Sample App connected from a Pixel 9 emulator and its plugins, and the Network Inspector showing the app's HTTP traffic

Active development

This project is under active development. We welcome feedback as we work toward a stable release. Please note that the Plugin SDK APIs are not yet finalized and may change in the future.

How it works ​

  • The host is a desktop application, the debugger UI, that you run on your development machine.
  • The agent is a small runtime you add to the app being debugged. It connects to the host over a WebSocket and exchanges type-safe messages powered by kotlinx.serialization.
  • Plugins are the debugging tools. Each is a JAR the host loads at runtime, usually paired with an agent plugin in the app; a few, like the Device Mirror, run in the host alone.

One host debugs several sessions at once — an Android device and a desktop app, say — each labeled with the app's name and icon and grouped by the device it runs on; see Session metadata. Apps on the host machine connect over plain ws on loopback, and physical devices over wss; see Connecting Devices.

Official plugins ​

PluginWhat it is forNeeds an agent in the app
Network InspectorHTTP traffic of Ktor and OkHttp clients, with response mockingYes
Compose Semantics InspectorThe semantics tree of a running screen, and driving it by nodeYes
Nav3 NavigatorThe Navigation 3 back stack, and pushing or popping entriesYes
Debug Actions (experimental)The app's debug menu as typed actionsYes
Storage InspectorThe app's files, caches and key-value storesYes
Device Mirror (experimental)Live screens of Android devices, iOS simulators and iPhonesNo

The host also embeds an MCP server (experimental), so an AI agent can use the same plugins.

Next steps ​

Released under the Apache License 2.0.