ClaudeCodeMod

All shelves / Mods / Workflow

android-logcat

By NathanWA

android-logcat is a Claude Code workflow mod by NathanWA.

Bounds Claude's adb logcat calls, redacts secrets from adb output, and keeps a pid-scoped logcat buffer for a logcat_grep tool and a /logcat pane.

Draws

Install

The marketplace name is claude-android-mods.

In Claude Code
/plugin install android-logcat --marketplace NathanWA/claude-android-mods
Open the repo

It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.

Version
0.2.0
License
MIT
Repo stars
4
Last change
2026-10-18

What it can reach

  • Draws in the session
  • Sees tool calls
  • Calls another program on this machine

Needs Claude Code 2.1.299 or newer, since function-hook mods are early access, the Android SDK's adb on your PATH or ANDROID_HOME or ANDROID_SDK_ROOT set, and an Android or KMP project as the working directory. The first install asks Add marketplace?: answer y, then choose a scope. A bare adb logcat call gets a bound, -d -t 800 or -t 200 --pid with the app's pid, so it cannot hang. The buffer follows the app when it restarts and gets a new pid, and logcat_grep warns if that pid looks stale. In the desktop app, adb calls fall back to the Bash tool and each asks for permission; adding Bash(adb *) to permissions.allow in ~/.claude/settings.json stops that. The README says the mods are early and have had little use on real projects and devices.

The marketplace, claude-android-mods, also holds android-device-console, android-project-lens, and build-output-distiller. Getting a device log to Claude in a size it can use, with secrets out, is why this page files it under workflow. olef, by olef-dev, shows the Android device and the last build in the status line, with toasts for a crash or failed request, beside a live device viewer Claude opens for you. context-diet, by drkokorev, replaces a huge tool output with a short digest and the path of a file that still holds the full text, and /diet opens a panel of what it saved. This one acts on adb: it bounds the logcat calls Claude makes, redacts secrets from what any adb call returns, and feeds each logcat line into a buffer scoped to the app's pid, which Claude searches with logcat_grep and you read with /logcat. In the source, a toast says what was redacted, and the adb result is withheld when redaction fails or the output is too large to redact (hooks/register.tsx:387, 398, 422).

Demo

The android-logcat entry of the Run section of the author's repository README: when Claude runs adb logcat the call is bounded and redacted, the model can search the buffer with logcat_grep, /logcat shows the buffer, and the buffer follows the app to a new pid with a warning if the pid looks stale.
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • tool.callAround a tool call, where it can hold oneBashmcp__android-logcat__logcat_grep
  • session.appendWhen an entry is written to the transcript
  • command.runWhen you run its slash command/logcat
  • ui.renderDraws into the sessionPane

Read from the on() calls in its hook modules. Open its source under Files to check what each one does.

Slash commands 1

  • /logcatShow android-logcat's pid-scoped logcat buffer in a pane

Files

The author's source, 3 files. They load when you open them.

Facts

Author
NathanWA
Category
Workflow
Marketplace
claude-android-mods
Repo
NathanWA/claude-android-mods
Folder
plugins/android-logcat
Version
0.2.0
License
MIT
Repo stars
4
Last change
2026-10-18
Language
TypeScript
Files
7

Other mods in Workflow

android-project-lensNathanWAHolds a commandAsks before Claude adds a permission that needs a Play Console declaration, gives it the real manifest SDKs and permissions, and adds a nav_graph route index.build-output-distillerNathanWASwaps Gradle console output for a short digest of errors and test failures with file:line lists and fix hints, flags a repeat failure, and opens a /build pane.plan-metervumichienDraws a one-line band above the prompt with how far your plan file is, in phases and steps, and how many of Claude's own tasks are done.idea-shelfvumichienParks an idea with /idea while Claude works, counts the shelf in a band, and sends nothing to the model until you press Send.session-monitorvumichienDraws a band of your other Claude Code sessions, how many wait on you, work, or are done, with their own line for sessions in this folder.caffeinezienagReminds the agent of each shell it left running in the background, and toasts when a reminder wakes an idle session.where-am-ihamzaferDraws four things above the prompt: the goal, what is happening now, what is waiting on you, and the next step.next-stepshamzaferAfter each turn, draws two or three likely next prompts. In an empty prompt, 1, 2, or 3 drafts one. 0 dismisses them.agent-radarhamzaferDraws one line above the prompt for each running subagent: time, tool count, and what it is doing.mission-controlhamzafer/mission opens a pane of the main agent, its subagents, every tool call, and the files they touch.agent-quick-menuagentic-workbenchPuts installed plugins' commands and settings, and Claude Code's own settings, in a pane beside the session, with a favorites line above the prompt.browser-laneshamzaferHolds a commandDraws whether this session has a Playwright browser and who holds it. A subagent that wants the browser waits until the one using it is done.
All 396 in Workflow