Pywayne Adb Logcat Reader

Read Android device logs in real-time via adb logcat using a C++ or Python backend with generator-style streaming output.

Security Scan

The skill's description claims a native C++ and Python module for real-time adb logcat reading, but the package provides no code, no install instructions, and does not declare the expected dependency on the adb binary—these mismatches merit caution.

Purpose & Capability

SKILL.md describes a pywayne.adb.logcat_reader module with a C++ backend and a Python backend for running adb logcat, but the skill bundle contains no code, no source link, and no install steps. It also does not declare that the adb binary is required despite relying on adb; this is internally inconsistent with the stated purpose.

Instruction Scope

The instructions are narrowly focused on using the described module and do not ask for unrelated files or credentials. However they assume the module and native backend already exist in the runtime; the absence of installation or provenance instructions leaves ambiguous what the agent should actually execute.

Install Mechanism

There is no install specification or source repository. The presence of a C++ backend implies compiled/native components that must be provided or installed, but no mechanism is given. Lack of source/homepage increases risk and prevents verification.

Credentials

The skill declares no required binaries or environment variables, yet its functionality fundamentally depends on the adb binary and access to connected Android devices (USB or network). Not declaring adb and omitting any permissions/requirements is disproportionate and misleading.

Persistence & Privilege

The skill does not request always-on inclusion and uses default autonomy settings. It does not ask to modify other skills or system-wide settings.

What to consider before installing

This skill appears to be documentation for a module that is not bundled here and has no source or install instructions. Before installing or enabling it: 1) Ask the publisher for the repository or a release URL and an install spec (pip package, wheel, or native binary). 2) Verify the pywayne.adb.logcat_reader package and its C++ backend exist and inspect their source. 3) Ensure your environment has the adb binary and that you understand device access/permissions (USB access can expose device logs). 4) Treat native/C++ components from unknown sources as higher risk—run in an isolated environment or container until provenance is confirmed. If you cannot verify the code/source, avoid enabling autonomous invocation or installing the skill.

This module provides real-time Android device log reading capabilities via the adb logcat command.

Quick Start

from pywayne.adb.logcat_reader import AdbLogcatReader

# Create reader (default C++ backend)
reader = AdbLogcatReader()

# Start log capture and read
reader.start()
for line in reader.read():
    print(line)

Use Python backend (alternative)

reader = AdbLogcatReader(backend='python') reader.start() for line in reader.read(): print(line)

# Stop and cleanup
reader.stop()

Initialization

# C++ backend (default, faster)
reader = AdbLogcatReader()

# Python backend (alternative, may be more compatible)
reader = AdbLogcatReader(backend='python')

Reading Logs

The read() method yields log lines incrementally as a generator, suitable for processing large logs or real-time monitoring.

# Process logs as they arrive
for line in reader.read():
    # Filter, parse, store...

Properties

Property	Description
backend	'cpp' or 'python'
running	Whether logcat process is running

Methods

Method	Description
start()	Start adb logcat process
read()	Generator yielding log lines
stop()	Stop logcat process
get_backend()	Get active backend type

Backends

C++ Backend (Default)

• Uses native C++ implementation
• Faster performance for real-time streaming
• Better compatibility with adb logcat

Python Backend (Alternative)

• Uses Python subprocess to call adb
• More compatible across different environments
• Easier debugging and integration

Notes

• C++ backend is faster and recommended for production
• Python backend may be useful during development
• stop() terminates adb logcat; use Ctrl+C to send interrupt signal
• Logs are cleared automatically when process stops