Launch on default device

---

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)