| name | android-llm-bridge |
| description | Unified Android debugging bridge for LLM agents. Abstracts adb / ssh / UART over a single interface; exposes structured tools via MCP, CLI, and a future Web API.
|
| version | 0.0.1 |
| homepage | https://github.com/TbusOS/android-llm-bridge |
| license | MIT |
android-llm-bridge · SKILL.md
This file is auto-generated from the registry. Do not edit by hand —
regenerate with: alb skills generate.
Invocation styles
- MCP (recommended): configure
alb-mcp in your client. All tools
appear with alb_ prefix. See llm/mcp-config-examples/.
- CLI:
uv run alb <group> <command> inside the repo.
- HTTP (M2): FastAPI surface; see docs/architecture.md.
Global conventions
- Every tool returns
{"ok", "data", "error", "artifacts", "timing_ms"}.
- On failure read
error.code (stable enum) and error.suggestion (actionable).
- Long outputs land in
workspace/devices/<serial>/<category>/.
Read them with alb_log_search / alb_log_tail.
- Dangerous commands are blocked by default. Use
allow_dangerous=True
for ASK-level ops; DENY is never bypassable.
Supported transports
| name | methods | status | requires |
|---|
| adb | A,B | beta | adb binary |
| ssh | C,D,F | beta | asyncssh, rsync (for rsync_sync) |
| serial | G | beta | pyserial-asyncio, ser2net (Windows for TCP mode) |
| hybrid | — | planned | — |
Capabilities (M1 ships 6)
| name | CLI | MCP tools | transports |
|---|
| shell | alb shell | alb_shell | adb, ssh, serial |
| logging | alb logcat / dmesg / log search / log tail + alb serial capture | alb_logcat, alb_dmesg, alb_uart_capture, alb_log_search, alb_log_tail | adb, ssh, serial |
| filesync | alb fs push / pull / rsync | alb_push, alb_pull, alb_rsync | adb, ssh |
| diagnose | alb diag bugreport / devinfo / anr pull / tombstone pull | alb_bugreport, alb_anr_pull, alb_tombstone_pull, alb_devinfo | adb, ssh |
| power | alb power reboot / wait-boot / battery / sleep-wake | alb_reboot, alb_wait_boot, alb_battery, alb_sleep_wake_test | adb, ssh, serial |
| app | alb app install / uninstall / start / stop / list / info / clear-data | alb_app_* | adb, ssh |
Full per-capability reference: docs/capabilities/
Full error catalog: docs/errors.md
