
Debug-only network inspector and performance monitor: captures every request without per-client code, in-session rules to mock/edit/fail, safe-by-default redaction, native viewer and AI-ready CLI.
Debug-only network inspector and performance monitor for Android, iOS (KMP) and JVM apps, with a native macOS viewer and a CLI built for AI agents.
[!WARNING] Experimental and developed entirely with AI (Claude Code). APIs may change. Debug builds only.
HttpURLConnection on Android, URLSession on iOS (SDKs
included), Ktor on the JVM. No per-client code.Group io.github.felipekoga.hopi, version 0.1.0, from mavenCentral() (plugin included; add it
to pluginManagement too). Before the first release: ./gradlew publishToMavenLocal here and
mavenLocal() in your repositories.
Android (application module):
plugins { id("io.github.felipekoga.hopi") version "0.1.0" }
dependencies {
debugImplementation("io.github.felipekoga.hopi:hopi-network:0.1.0")
debugImplementation("io.github.felipekoga.hopi:hopi-perf:0.1.0") // optional
}iOS (KMP): the same block in the shared module, then Hopi.shared.start() first thing at
launch in Swift. Release builds link nothing.
JVM (Ktor): hopi-ktor + hopi-start, call HopiStart.start() before building clients, and
install(Hopi) in each HttpClient.
Details, options and requirements (Kotlin 2.2+, AGP 8+, Gradle 8+): Guide.
Finds debug apps on Android phones and emulators (USB or Wi-Fi), iPhones on USB, iOS simulators and JVM processes. Requests and detail side by side, rules ("Mock This Response" from any request), live performance charts, cURL, HAR/NDJSON export, whole bodies while attached.
| Rules | Performance |
|---|---|
![]() |
![]() |
Download the .dmg from Releases (macOS 26; unsigned
for now: right-click, Open) or build it: scripts/mac-dmg.sh (Xcode 26+).
Every command has --json (one object per line, a stable contract) and clear exit codes. Build
with ./gradlew :hopi-cli:installDist (hopi-cli/build/install/hopi-cli/bin/hopi).
hopi apps # apps with Hopi; with one, --app is optional
hopi list --status 4xx,5xx,failed --url /users # filter what was captured
hopi wait --url /login --json # block until a new matching request ends
hopi get 42 --body response | jq . # one body, raw
hopi tail --full-bodies --json # live, whole bodies
hopi mock add --from 42 --status 500 # mock that request's response
hopi export > session.har # HAR or NDJSON
hopi perf start --frames --hangs && hopi hangs # monitorsAll commands: Log stream and CLI.
Guide · Architecture · Roadmap · Releasing · building and the base check: Building
Inspired by Pulse, Chucker, Flipper, DebugSwift, Pluto, netfox and Wormholy.
Apache-2.0 (LICENSE).
Debug-only network inspector and performance monitor for Android, iOS (KMP) and JVM apps, with a native macOS viewer and a CLI built for AI agents.
[!WARNING] Experimental and developed entirely with AI (Claude Code). APIs may change. Debug builds only.
HttpURLConnection on Android, URLSession on iOS (SDKs
included), Ktor on the JVM. No per-client code.Group io.github.felipekoga.hopi, version 0.1.0, from mavenCentral() (plugin included; add it
to pluginManagement too). Before the first release: ./gradlew publishToMavenLocal here and
mavenLocal() in your repositories.
Android (application module):
plugins { id("io.github.felipekoga.hopi") version "0.1.0" }
dependencies {
debugImplementation("io.github.felipekoga.hopi:hopi-network:0.1.0")
debugImplementation("io.github.felipekoga.hopi:hopi-perf:0.1.0") // optional
}iOS (KMP): the same block in the shared module, then Hopi.shared.start() first thing at
launch in Swift. Release builds link nothing.
JVM (Ktor): hopi-ktor + hopi-start, call HopiStart.start() before building clients, and
install(Hopi) in each HttpClient.
Details, options and requirements (Kotlin 2.2+, AGP 8+, Gradle 8+): Guide.
Finds debug apps on Android phones and emulators (USB or Wi-Fi), iPhones on USB, iOS simulators and JVM processes. Requests and detail side by side, rules ("Mock This Response" from any request), live performance charts, cURL, HAR/NDJSON export, whole bodies while attached.
| Rules | Performance |
|---|---|
![]() |
![]() |
Download the .dmg from Releases (macOS 26; unsigned
for now: right-click, Open) or build it: scripts/mac-dmg.sh (Xcode 26+).
Every command has --json (one object per line, a stable contract) and clear exit codes. Build
with ./gradlew :hopi-cli:installDist (hopi-cli/build/install/hopi-cli/bin/hopi).
hopi apps # apps with Hopi; with one, --app is optional
hopi list --status 4xx,5xx,failed --url /users # filter what was captured
hopi wait --url /login --json # block until a new matching request ends
hopi get 42 --body response | jq . # one body, raw
hopi tail --full-bodies --json # live, whole bodies
hopi mock add --from 42 --status 500 # mock that request's response
hopi export > session.har # HAR or NDJSON
hopi perf start --frames --hangs && hopi hangs # monitorsAll commands: Log stream and CLI.
Guide · Architecture · Roadmap · Releasing · building and the base check: Building
Inspired by Pulse, Chucker, Flipper, DebugSwift, Pluto, netfox and Wormholy.
Apache-2.0 (LICENSE).