Privacy-first Android AI assistant that lets users circle or touch any element on their screen, then calls a fully on-device AI engine to transcribe, summarize, explain, or draft responses.

Features

System-wide accessibility overlay
Touch/gesture detection
Local AI inference (no cloud calls)
Privacy: No data leaves device

Quick Start

1. Setup Development Environment

# One-time setup (installs Android SDK and tools)
./setup.sh

2. Connect Your Android Device

See PHONE_SETUP.md for detailed setup instructions.

3. Build and Install

make check-device  # Check if device is connected
make build         # Build APK
make install       # Install to device
make run           # Launch app

3. Enable Accessibility Service

Open Crkl app (shows welcome screen)
Tap "Open Accessibility Settings"
Find "Crkl Overlay Service" and toggle ON
Accept permission dialog

4. Test It

make logs       # Watch logs

Touch your phone screen anywhere - you'll see touch detection logs and visual feedback (cyan circles).

Commands

Setup Commands

./setup.sh      # One-time setup (installs Android SDK)
make setup-sdk   # Install Android SDK and tools
make check-device # Check if device is connected

Development Commands

make build      # Build APK
make install    # Install to device
make run        # Launch app
make logs       # Watch app logs
make stop       # Stop app
make clean      # Clean build
make uninstall  # Remove app

Help

make help       # Show all available commands

Project Structure

crkl/
├── app/src/main/kotlin/com/example/crkl/
│   ├── MainActivity.kt                    # Main app activity
│   ├── accessibility/
│   │   ├── CrklAccessibilityService.kt   # System overlay service
│   │   └── OverlayView.kt                # Touch detection view
│   └── ui/theme/                         # App theming
├── app/src/main/res/                     # Resources
├── Makefile                              # Build commands
├── PHONE_SETUP.md                        # Phone setup guide
└── README.md                             # This file

Development

The POC is complete with:

✅ System-wide overlay
✅ Touch detection
✅ Visual feedback
✅ Logging

Next: Add gesture recognition, content detection, and AI integration.

Requirements

Android phone (Android 8.1+)
Android SDK on Linux
USB debugging enabled