Repolode
Submit
dutradotdev

dutradotdev/quokka

A Mac terminal CLI to inspect and clean an iPhone or Android device over USB: storage, apps, media, and live logs.

View on GitHub
Stars
112
Forks
2
Open issues
2
Last commit
3 months ago

What is it?

quokka is a macOS command-line tool for a phone connected by cable, supporting both iPhone and Android. It reads storage, battery, installed apps, media files, device identity, and the live system log, and can also free up space or reboot and power off the device.

iPhones are reached through usbmuxd and lockdown services, and Android devices through a local adb server. Neither path requires a jailbreak or root, and quokka runs without elevated privileges. It supports iOS 17+ and Android 8+.

The tool ships as two binaries, quokka and the shorter qk, with an interactive launcher when run with no arguments. Most query commands accept --json for scripting, and --redact masks serial numbers, UDIDs, IMEI, and MAC addresses before sharing output.

Key features

  • 01Live TUI log viewer with level and process filters, search, and save.
  • 02Ranks the heaviest media files and groups likely duplicates.
  • 03Lists installed user apps by size and uninstalls by bundle id.
  • 04Shows device, system, and network identity with optional redaction.
  • 05Supports --json output for scripting, and a --udid flag to target a specific device.

Use cases

  • Tailing a test iPhone or Android's system log while debugging an app.
  • Freeing storage on a test device by finding large media and duplicates.
  • Capturing device info for screenshots or bug reports with sensitive identifiers masked.
  • Scripting device checks in CI with --json and non-interactive flags.

Quick start

  1. 1

    Install quokka with Homebrew

    brew install dutradotdev/tap/quokka-cli
  2. 2

    Run qk to open the interactive launcher

    qk

Things to know

  • macOS only; runs on a Mac with the phone connected by cable.
  • iPhone needs iOS 17 or newer, and Android needs Android 8 or newer.
  • Without root on Android, app names show as package ids and battery health is unavailable.
  • Packet capture (qk capture) is iOS-only.

In collections

CLI & terminal toolsOpen-source Mac appsAndroid apps & phone tools

Topics

#macos#cli#terminal#ios#android#adb#usb#device-management#logs

FAQ

What is quokka?
A Mac terminal CLI to inspect and clean an iPhone or Android device over USB: storage, apps, media, and live logs. quokka is a macOS command-line tool for a phone connected by cable, supporting both iPhone and Android. It reads storage, battery, installed apps, media files, device identity, and the live system log, and can also free up space or reboot and power off the device.
Is quokka free to use? What license does it have?
quokka is open source under the MIT license. Check the license terms before using it in commercial products.
Is quokka still maintained?
Updated within 6 months. The last commit to quokka was on Jul 27, 2026.
What can I use quokka for?
Tailing a test iPhone or Android's system log while debugging an app. Freeing storage on a test device by finding large media and duplicates. Capturing device info for screenshots or bug reports with sensitive identifiers masked. Scripting device checks in CI with --json and non-interactive flags.
How do I install quokka?
Install quokka with Homebrew: brew install dutradotdev/tap/quokka-cli Run qk to open the interactive launcher: qk
Where can I get quokka?
The source code and installation instructions are on GitHub: https://github.com/dutradotdev/quokka

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects

peetzweg / opendisplay

Turns an iPhone, iPad, or spare Mac into a true extended second display for your Mac over USB or WiFi, free and open source.

Mobile & Desktop#macos#ios#screen-extension
6.2K+166 this week427SwiftGPL-3.0Well maintainedUpdated 14 hours ago