Real-time observability for debug builds of Android and iOS apps. Traffic, traces, events, database state, errors, cache, and feature flags — captured automatically, browsable in an in-app console and a Compose Desktop companion. Full observability in debug. Zero overhead in Android release builds.
Documentation · Setup Guide · Releases
val alohomoraVersion = "1.4.0" // latest: see the Release badge above
dependencies {
debugImplementation("io.github.yashkasera:alohomora:$alohomoraVersion")
releaseImplementation("io.github.yashkasera:alohomora-noop:$alohomoraVersion")
}Android auto-initializes via AndroidX Startup. Shake the device to open the console. The DevTools server for the desktop companion runs in any debuggable build; the Gradle plugin is optional.
Full setup guide → (Gradle plugin, iOS, traffic capture, desktop app)
| Feature | What it does | |
|---|---|---|
| 📡 | Traffic | Every request captured with headers, bodies, timing. OkHttp + Ktor auto-capture |
| 🔁 | Traffic Replay | Edit and re-send through your own HTTP client, signatures regenerated |
| 📊 | Traces | Waterfall view of distributed spans. Adapters for OpenTelemetry, Sentry |
| 📋 | Events | Searchable timeline with properties |
| 🗄️ | Database | Browse tables, run SQL, view schema |
| 🚨 | Errors | Uncaught exceptions auto-captured, chains to Crashlytics/Sentry |
| 💾 | Cache | SharedPreferences / NSUserDefaults inspection |
| 🏴 | Feature Flags | Record and inspect from any provider |
| 🎭 | Mock Rules | Intercept requests, return custom responses with template generators |
| 🐢 | Throttling | Edge to Wi-Fi presets, device-wide via local VPN |
| 🔗 | Deep Links | Compose, fire, and replay deep links from the desktop |
| 🤖 | MCP Server | Expose captured data to AI coding assistants |
| ⚙️ | Config & Git | Branch, SHA, dirty flag, last N commits baked into the build |
| ⌨️ | Command Palette | Cmd+K for everything |
| 🖥️ | Desktop Companion | Full-screen debugging on macOS, Windows, Linux |
Two artifacts, same API. debugImplementation gets full observability — Room DB, TCP server,
Compose UI. releaseImplementation gets empty method bodies that R8 optimises away (<10 KB).
The desktop companion connects via ADB port forwarding and renders all captured data.
- Setup Guide — Android, iOS, Gradle plugin, desktop companion
- Features — Traffic, replay, mocks, database, errors, and more
- Traces & Adapters — OpenTelemetry, Sentry, Datadog, Firebase
- MCP Server — Expose debug data to AI agents
- API Reference — Every method on the Alohomora singleton
A metrics dashboard, a logging service, or a monitoring tool that alerts after damage is done. It is a thinking aid for developers who debug systems, not just code.