adb-magisk

Quick Reference (30 seconds)

Magisk Manager Automation

What It Does: Automates Magisk Manager application for module management and configuration. Handles app launching, Zygisk enabling, and module installation workflows.

Core Capabilities:

🚀 App Launching: Open Magisk Manager with auto-detection
⚙️ Zygisk Configuration: Enable/disable Zygisk subsystem
📦 Module Installation: Automated module zip installation
🔄 State Verification: Confirm configuration changes

When to Use:

Need to configure Magisk for app modifications
Installing custom modules (like PlayIntegrityFork)
Enabling Zygisk for API hooking
Automating Play Integrity bypass setup

Scripts

adb-magisk-launch.py

Launch Magisk Manager application.

# Launch on default device
uv run .claude/skills/adb-magisk/scripts/adb-magisk-launch.py

# Specify device
uv run .claude/skills/adb-magisk/scripts/adb-magisk-launch.py --device 127.0.0.1:5555

# Wait for app to load
uv run .claude/skills/adb-magisk/scripts/adb-magisk-launch.py --wait-text "Modules"

# JSON output
uv run .claude/skills/adb-magisk/scripts/adb-magisk-launch.py --json

adb-magisk-enable-zygisk.py

Enable Zygisk in Magisk settings (prerequisite for API hooking).

# Enable Zygisk
uv run .claude/skills/adb-magisk/scripts/adb-magisk-enable-zygisk.py --device 127.0.0.1:5555

# Verify after enabling (auto-waits for reboot prompt)
uv run .claude/skills/adb-magisk/scripts/adb-magisk-enable-zygisk.py \
    --device 127.0.0.1:5555 \
    --auto-reboot

# JSON output
uv run .claude/skills/adb-magisk/scripts/adb-magisk-enable-zygisk.py --json

adb-magisk-install-module.py

Install Magisk module from zip file.

# Install module
uv run .claude/skills/adb-magisk/scripts/adb-magisk-install-module.py \
    --device 127.0.0.1:5555 \
    --module-path /sdcard/PlayIntegrityFork.zip

# Verify after installation
uv run .claude/skills/adb-magisk/scripts/adb-magisk-install-module.py \
    --device 127.0.0.1:5555 \
    --module-path /sdcard/PlayIntegrityFork.zip \
    --verify

# JSON output
uv run .claude/skills/adb-magisk/scripts/adb-magisk-install-module.py \
    --device 127.0.0.1:5555 \
    --module-path /sdcard/PlayIntegrityFork.zip \
    --json

Workflows

magisk-setup.toon

Complete Magisk setup with Zygisk enablement.

name: Setup Magisk with Zygisk
description: Configure Magisk for API hooking with Zygisk subsystem

parameters:
  device: "127.0.0.1:5555"
  timeout: 15

phases:
  - id: phase1_launch
    name: "Launch Magisk Manager"
    steps:
      - id: launch
        action: adb-magisk-launch
        params:
          device: "{{ device }}"
          wait_text: "Modules"
          timeout: "{{ timeout }}"

  - id: phase2_enable_zygisk
    name: "Enable Zygisk"
    steps:
      - id: enable
        action: adb-magisk-enable-zygisk
        params:
          device: "{{ device }}"
          auto_reboot: false

      - id: verify
        action: adb-wait-for
        params:
          method: text
          target: "Zygisk enabled"
          timeout: 10

recovery:
  - on_error: phase2_enable_zygisk
    action: retry
    max_attempts: 2
    delay: 2

install-module.toon

Module installation workflow (used by Play Integrity bypass).

name: Install Magisk Module
description: Install module zip file via Magisk Manager

parameters:
  device: "127.0.0.1:5555"
  module_path: "/sdcard/PlayIntegrityFork.zip"
  timeout: 20

phases:
  - id: phase1_launch
    name: "Launch Magisk Manager"
    steps:
      - id: launch
        action: adb-magisk-launch
        params:
          device: "{{ device }}"

  - id: phase2_navigate
    name: "Navigate to Modules"
    steps:
      - id: wait_modules_tab
        action: adb-wait-for
        params:
          method: text
          target: "Modules"
          timeout: 5

      - id: tap_modules
        action: adb-tap
        params:
          x: 100
          y: 100
          device: "{{ device }}"

  - id: phase3_install
    name: "Install Module"
    steps:
      - id: tap_fab
        action: adb-tap
        params:
          x: 400
          y: 800
          device: "{{ device }}"

      - id: wait_file_picker
        action: adb-wait-for
        params:
          method: text
          target: "Select file"
          timeout: 5

      - id: select_module
        action: adb-file-select
        params:
          path: "{{ module_path }}"

      - id: wait_completion
        action: adb-wait-for
        params:
          method: text
          target: "Installation complete"
          timeout: "{{ timeout }}"

recovery:
  - on_error: phase3_install
    action: adb-screenshot-capture
    then: continue

Usage Patterns

Pattern 1: Setup Magisk for Hooking

# Execute setup workflow
uv run .claude/skills/adb-workflow-orchestrator/scripts/adb-run-workflow.py \
    --workflow .claude/skills/adb-magisk/workflows/magisk-setup.toon \
    --param device=127.0.0.1:5555

Pattern 2: Install PlayIntegrityFork Module

# Execute installation workflow
uv run .claude/skills/adb-workflow-orchestrator/scripts/adb-run-workflow.py \
    --workflow .claude/skills/adb-magisk/workflows/install-module.toon \
    --param device=127.0.0.1:5555 \
    --param module_path=/sdcard/PlayIntegrityFork.zip

Pattern 3: Verify Magisk Configuration

# Launch and verify Zygisk is enabled
uv run .claude/skills/adb-magisk/scripts/adb-magisk-launch.py \
    --device 127.0.0.1:5555 \
    --wait-text "Zygisk" \
    --timeout 10

Integration Points

Depends On:

adb-screen-detection (screenshot, find-element, tap verification)
adb-navigation-base (tap, swipe, wait-for)
adb-workflow-orchestrator (orchestration of complex flows)

Used By:

adb-karrot (for Play Integrity bypass setup)
Custom automation workflows

Magisk Manager UI Reference

Home Screen
  ├─ Modules tab (module list)
  ├─ Settings tab (Zygisk toggle)
  └─ Superuser tab (permission management)

Modules Tab
  ├─ + FAB (install module)
  ├─ Module list (installed modules)
  └─ Enable/disable toggles

File Picker
  ├─ /sdcard (default storage location)
  ├─ Select zip file
  └─ Confirm installation

Installation Dialog
  ├─ Progress bar
  ├─ Installation complete
  └─ Reboot required (optional)

Version: 1.0.0 Status: ✅ App-Specific Tier Scripts: 3 Workflows: 2 Last Updated: 2025-12-01 Tier: 3 (App-Specific)

Installation

Also in this package

Agent compatibility

Skill metadata

Package contents

History

SKILL.md