Update README.md

Author: xaionaro@dx.center

README.md

@@ -10,6 +10,39 @@ Call Android system services from pure Go. Provides ~12000 type-safe Go methods
 
 Includes a complete AIDL compiler that parses Android Interface Definition Language files and generates the Go proxies, a version-aware runtime that adapts transaction codes across Android API levels, and a CLI tool (`bindercli`) for interactive service discovery and invocation.
 
+## What can it do?
+
+- **Query system services** — battery level, GPS location, thermal status, running processes, installed packages
+- **Control hardware** — connect to WiFi, toggle flashlight, manage Bluetooth, configure audio
+- **Interact with any binder service** — ActivityManager, PowerManager, SurfaceFlinger, camera/sensor HALs, and 600+ more
+- **No Java, no cgo** — pure Go, cross-compiles to a static binary, runs on Android or any Linux with `/dev/binder`
+- **CLI tool included** — `bindercli` for interactive service discovery, method invocation, and debugging
+
+## Quick start
+
+**CLI** — download from [releases](https://github.com/xaionaro-go/binder/releases) and push to device:
+
+```bash
+adb push bindercli /data/local/tmp/ && adb shell chmod 755 /data/local/tmp/bindercli
+adb shell /data/local/tmp/bindercli service list          # list all services
+adb shell /data/local/tmp/bindercli battery level          # check battery
+adb shell /data/local/tmp/bindercli location providers     # list GPS providers
+```
+
+**Go library** — `go get github.com/xaionaro-go/binder` and call any service:
+
+```go
+driver, _ := kernelbinder.Open(ctx, binder.WithMapSize(128*1024))
+defer driver.Close(ctx)
+sm := servicemanager.New(driver)
+svc, _ := sm.GetService(ctx, "activity")
+am := app.NewActivityManagerProxy(svc)
+limit, _ := am.GetProcessLimit(ctx)
+```
+
+<details>
+<summary>Related projects: ndk, jni, binder (click to expand)</summary>
+
 ## Android Interfaces for Go
 
 This project is part of a family of three Go libraries that cover the major Android interface surfaces. Each wraps a different layer of the Android platform:
@@ -69,6 +102,8 @@ All three libraries talk to the same Android system services, but through differ
 - The **Java SDK** uses binder IPC internally for system service access (BluetoothManager, LocationManager, etc.), routing calls through the Android Runtime (ART/Dalvik). The `jni` library calls into these Java APIs via the JNI C interface and cgo.
 - The **AIDL binder protocol** is the underlying IPC mechanism that system-facing NDK and Java SDK APIs use. The `binder` library implements this protocol directly in pure Go, bypassing both C and Java layers entirely.
 
+</details>
+
 ## Usage Examples
 
 ### List Binder Services
@@ -1750,16 +1785,6 @@ Each binder method has a numeric transaction code that can differ between Androi
 
 Methods 2 and 3 exist only for extra reliability in edge cases (e.g. no read access to `/system/framework/`). The `genversions` tool builds the version tables by checking out AOSP revision tags and recording method→code mappings.
 
-The resolved table can be cached to disk for fast subsequent startups by passing `OptionCachePath`:
-
-```go
-transport, err := versionaware.NewTransport(ctx, driver, 0,
-    versionaware.OptionCachePath("/data/local/tmp/binder-codes.json"),
-)
-```
-
-Caching is disabled by default. The cache is fingerprinted and automatically invalidated when the device firmware changes.
-
 ## Testing and Verification
 
 The project is verified at four levels: