Updated findings: Hook system completely broken, but custom commands/agents work (v2.0.76)

[pybe]

Environment

• Claude Code Version: 2.0.76
• Node.js: v25.2.1
• Platform: android arm64
• Device RAM: 10.8 GB
• Date tested: 2026-01-07

Summary

Tested the known issues documented in this repo against a current Termux setup. Found some discrepancies with the documented limitations.

Findings

✅ Issues FIXED/Working (contrary to repo docs)

Issue	Repo Status	Actual Status	Fix
Image reading	❌ Unavailable	✅ Working	npm install @img/sharp-wasm32 --force && npm install sharp --force
WebAssembly	❌ Missing	✅ Available	Built into Node.js v25
Custom slash commands	❌ Disabled	✅ Working	Commands in ~/.claude/commands/ load fine
Custom subagents	❌ Not discovered	✅ Working	Agents in ~/.claude/agents/ load fine

❌ Issues WORSE than documented

Issue	Repo Status	Actual Status
PostToolUse hooks	❌ Not firing	❌ Confirmed broken
ALL other hooks	✅ Working (per repo)	❌ Also broken

Hook System Testing Details

The repo documentation suggests only PostToolUse hooks are broken. Testing reveals ALL hooks fail to fire automatically:

Events logged in current session:
- SessionStart: 0 (should fire at session start)
- PreToolUse: 0 (should fire before each tool)
- PostToolUse: 0 (should fire after each tool)

However, manual execution works perfectly:

# Manual test - works fine
echo '{"tool_name":"Bash"}' | ~/.claude/Hooks/my-hook.ts --event-type PostToolUse
# ✅ Event logged successfully

This confirms the issue is with Claude Code's internal event dispatcher on Android/arm64, not with the hook scripts themselves.

Sharp/Image Reading Fix

The documented workaround works perfectly:

npm install @img/sharp-wasm32 --force
npm install sharp --force

After this fix:

• Sharp loads with emscripten/WASM build
• Image reading fully functional
• ~12ms per image processing time

Custom Commands/Agents

Contrary to the repo documentation and GitHub issues #9435 and #11205, custom commands and agents do work on my setup:

• ~/.claude/commands/upload-report.md → Loaded and visible in / menu
• ~/.claude/agents/*.md → All 4 custom agents loaded and functional

This may be version-specific (v2.0.76) or configuration-dependent.

Recommendations

1. Update the KNOWN_ISSUES.md to reflect that custom commands/agents may work in newer versions
2. Add the sharp WASM fix to the install script
3. Escalate the hooks issue - it's more severe than GitHub #15617 suggests (all hooks broken, not just PostToolUse)

Related GitHub Issues

• #2248 - Sharp/Image reading (closed, workaround available)
• #9435 - Custom slash commands (may be fixed in v2.0.76)
• #11205 - Custom subagents (may be fixed in v2.0.76)
• #15617 - PostToolUse hooks (actually ALL hooks broken)

---

Happy to provide more details or test specific scenarios. Great work on this repo - it's a valuable resource for Termux users!

[pybe]

Update: Hooks now working with platform detection patch ✅

I've confirmed that the root cause of hooks not firing on Termux is platform detection. Node.js reports process.platform === "android" on Termux, but Claude Code only checks for darwin, win32, and linux.

The fix:

1. Locate cli.js:

   /data/data/com.termux/files/usr/lib/node_modules/@anthropic-ai/claude-code/cli.js

2. Replace all instances of:

   process.platform==="linux"

   with:

   (process.platform==="linux"||process.platform==="android")

3. Also check for minified variants like DQ.platform==="linux" or U00.platform==="linux" (variable names may differ by version)

4. Restart Claude Code

After patching, all hooks fire correctly:

• SessionStart ✅
• PreToolUse ✅
• PostToolUse ✅
• SubagentStop ✅
• Stop ✅

I've also filed this upstream: anthropics/claude-code#16615

This would be a great addition to the repo's documentation or install script!

[pybe]

Reusable Patch Script

Here's a script that automates the hook fix. Save it and run after each Claude Code update:

#\!/data/data/com.termux/files/usr/bin/bash
#
# patch-termux-hooks
# Patches Claude Code cli.js to enable hooks on Termux/Android
#
# Usage: patch-termux-hooks [--rollback]
#

set -e

CLI_PATH="/data/data/com.termux/files/usr/lib/node_modules/@anthropic-ai/claude-code/cli.js"
BACKUP_DIR="$HOME/.claude/History/backups"
BACKUP_FILE="$BACKUP_DIR/cli.js.backup.$(date +%Y%m%d%H%M%S)"

RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'

print_status() { echo -e "${GREEN}[✓]${NC} $1"; }
print_warning() { echo -e "${YELLOW}[\!]${NC} $1"; }
print_error() { echo -e "${RED}[✗]${NC} $1"; }

find_latest_backup() {
    ls -t "$BACKUP_DIR"/cli.js.backup.* 2>/dev/null | head -1
}

rollback() {
    local latest=$(find_latest_backup)
    if [[ -z "$latest" ]]; then
        print_error "No backup found in $BACKUP_DIR"
        exit 1
    fi
    print_status "Found backup: $latest"
    cp "$latest" "$CLI_PATH"
    print_status "Rolled back to backup"
    print_warning "Restart Claude Code for changes to take effect"
    exit 0
}

patch_cli() {
    if [[ \! -f "$CLI_PATH" ]]; then
        print_error "cli.js not found at: $CLI_PATH"
        exit 1
    fi

    mkdir -p "$BACKUP_DIR"

    if grep -q 'process.platform==="android"' "$CLI_PATH" 2>/dev/null; then
        print_warning "cli.js appears to already be patched"
        read -p "Re-apply patch anyway? (y/N) " -n 1 -r
        echo
        [[ \! $REPLY =~ ^[Yy]$ ]] && exit 0
    fi

    cp "$CLI_PATH" "$BACKUP_FILE"
    print_status "Backup created: $BACKUP_FILE"

    local count_before=$(grep -c 'platform==="linux"' "$CLI_PATH" 2>/dev/null || echo "0")
    print_status "Found $count_before platform checks to patch"

    # Patch process.platform==="linux"
    sed -i 's/process\.platform==="linux"/(process.platform==="linux"||process.platform==="android")/g' "$CLI_PATH"

    # Patch minified variants (XX.platform==="linux")
    sed -i 's/\([A-Za-z0-9_]\{1,4\}\)\.platform==="linux"/(\1.platform==="linux"||\1.platform==="android")/g' "$CLI_PATH"

    print_status "Patch complete\!"
    print_warning "Restart Claude Code for changes to take effect"
    echo "To rollback: $0 --rollback"
}

case "${1:-}" in
    --rollback|-r) rollback ;;
    --help|-h)
        echo "Usage: $(basename $0) [--rollback]"
        echo "Patches Claude Code to enable hooks on Termux"
        exit 0 ;;
    "") patch_cli ;;
    *) print_error "Unknown option: $1"; exit 1 ;;
esac

Quick install:

# Download and run
curl -sL https://gist.githubusercontent.com/YOUR_USERNAME/GIST_ID/raw/patch-termux-hooks > $PREFIX/bin/patch-termux-hooks
chmod +x $PREFIX/bin/patch-termux-hooks
patch-termux-hooks

Or copy the script above to a file and run it manually.

After Claude Code updates:

npm update -g @anthropic-ai/claude-code
patch-termux-hooks

Feel free to incorporate this into the repo's install process!

[pybe]

Gist now available for easy install:

curl -sL https://gist.githubusercontent.com/pybe/1b7f7d97097a20b0101a22e9cefbe5b7/raw/patch-termux-hooks > $PREFIX/bin/patch-termux-hooks
chmod +x $PREFIX/bin/patch-termux-hooks
patch-termux-hooks

Gist: https://gist.github.com/pybe/1b7f7d97097a20b0101a22e9cefbe5b7

Re-run after each Claude Code update.