claude-code-for-android

Claude Code for Android

Automated Android code review for Kotlin/Java code — security, quality, and performance checks based on Google's official Android best practices.

Key Features: Zero configuration • 90% confidence threshold • ~55% token optimization • Compatible with all Claude providers

---

Quick Start

Installation (Marketplace)

# Step 1: Add marketplace
/plugin marketplace add daishengda2018/claude-code-for-android

# Step 2: Install plugin
/plugin install claude-code-for-android@claude-code-for-android

# Step 3: Verify installation
/plugin

Manual Installation

# Clone repository
git clone https://github.com/daishengda2018/claude-code-for-android.git
cd claude-code-for-android

# Copy plugin files to ~/.claude/
cp -r commands/* ~/.claude/commands/
cp -r agents/* ~/.claude/agents/
cp -r skills/* ~/.claude/skills/

# Restart Claude Code

Note: Manual installation requires restarting Claude Code to load the plugin.

---

Usage

Review Local Changes (Default)

# Smart auto-detection (zero configuration)
/android-code-review

The plugin automatically detects what to review:

1. Staged changes → git diff --staged
2. Unstaged changes → git diff
3. Last commit → git log -1 --patch

In case you only want to review the stated files:

# Explicit staged changes
/android-code-review --target staged

Review Specific File

/android-code-review --target file:app/src/main/java/com/example/MyFragment.kt

Severity Filtering

# Security-only (fastest)
/android-code-review --severity critical

# High-severity (default)
/android-code-review --severity high

# All checks
/android-code-review --severity all

JSON Output (CI/CD)

android-code-review --output-format json > review.json

Pull Request Review

Review Specific PR

# Review a PR by number
/android-code-review --target pr:123

# High-severity only (faster)
/android-code-review --target pr:123 --severity high

# Export as JSON for archiving
/android-code-review --target pr:123 --output-format json > pr-123-review.json

Note: The default behavior reviews local git changes, not pull requests. Use --target pr:<number> for PR review.

---

Detection Coverage

Category	Checks
Security	Hardcoded secrets, insecure storage, Intent hijacking, WebView flaws, cleartext traffic
Code Quality	Memory leaks, error handling, large functions, deep nesting, dead code
Android Patterns	Lifecycle violations, ViewModel misuse, deprecated APIs, permissions
Jetpack/Kotlin	Coroutine misconfiguration, Room issues, Hilt errors, Compose anti-patterns
Performance	ANR risks, layout inefficiencies, bitmap mismanagement, startup bottlenecks
Best Practices	Naming conventions, documentation, accessibility, resource management

---

Token Cost by Severity (V3.0.6)

Severity	Patterns Loaded	Token Cost	Use Case
critical	Security only	~1,500	Fast security scan
high	Security + Quality + Architecture	~6,950	Default review
medium	Above + Performance	~8,100	Comprehensive review
all	All patterns	~8,900	Complete analysis

---

Plugin Architecture

Directory Structure

claude-code-for-android/
├── commands/
│   └── android-code-review.md         # User-facing command
├── agents/
│   └── android-code-reviewer.md       # Code review agent
├── skills/
│   └── android-code-review/
│       └── SKILL.md                   # Detection rules orchestration
├── .claude-plugin/                    # Marketplace metadata
│   ├── plugin.json                    # Plugin manifest
│   └── marketplace.json               # Marketplace description
└── [other files]

Execution Flow