adb-tui

Android meets AI. From your terminal.

A full-featured terminal UI and MCP server for Android Debug Bridge.
Control any Android device with keystrokes, or let AI do it for you.

Install · Views · MCP + AI · CLI · 中文文档

---

adb-tui gives you a complete Android debugging dashboard in one terminal window. 11 interactive views, each one keystroke away. No commands to memorize, no output to parse.

It also doubles as an MCP server with 120+ tools, turning any Android device into an AI-controllable endpoint. Claude, or any MCP-compatible agent, can install apps, stream logs, capture screens, manage files, and more, all autonomously.

Highlights

• Full ADB coverage: devices, shell, logcat, files, packages, processes, ports, input, settings, performance
• AI-native: built-in MCP server (stdio + HTTP/SSE) for Claude and other AI agents
• Real-time logcat: stream, filter by level/tag/PID, search, export, handles 10k+ entries
• Wireless debugging: one-key switch between USB and TCP/IP
• Secure: all shell commands use parameterized execution, no injection vectors
• Cross-platform: macOS, Linux, Windows. Any ADB-compatible Android device or emulator
• Zero config: install and run

Install

macOS (Homebrew)

brew install alanisme/tap/adb-tui

Linux / macOS (script)

curl -fsSL https://raw.githubusercontent.com/alanisme/adb-tui/main/install.sh | sh

Windows (PowerShell)

irm https://raw.githubusercontent.com/alanisme/adb-tui/main/install.ps1 | iex

Go

go install github.com/alanisme/adb-tui/cmd/adb-tui@latest

From source

git clone https://github.com/alanisme/adb-tui.git
cd adb-tui
make build

GitHub Releases

Pre-built binaries for all platforms available on the Releases page.

Prerequisite: ADB must be installed and in your PATH.

TUI Views

Press a number key to jump to any view instantly.

Key	View	What you can do
1	Devices	Connect, disconnect, wireless toggle, ADB version display
2	Info	Hardware specs, battery, storage, network, CPU at a glance
3	Shell	Interactive shell with command history
4	Logcat	Real-time log streaming with level/tag/search filters and export
5	Files	Browse filesystem, push/pull files, manage permissions
6	Packages	Install/uninstall APKs, manage permissions, view APK paths
7	Port Forward	TCP forward and reverse port rules
8	Input	Tap, swipe, long press, key events, text injection
9	Processes	Process list, kill by PID or name, per-app memory info
0	Settings	Read/write system, secure, and global settings
-	Performance	Live CPU, memory, battery, and display metrics

? help · / search · Tab cycle views · j/k navigate · T theme · q quit (confirm) · ^c quit

MCP Server & AI Integration

adb-tui implements the Model Context Protocol, turning your Android device into a tool-equipped endpoint for AI agents.

This means Claude, or any MCP-compatible client, can:

• Install and manage apps
• Read and filter logcat output
• Push/pull files, take screenshots, record screen
• Control touch input and key events
• Query device info, battery, network status
• Manage system settings and permissions

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "adb": {
      "command": "adb-tui",
      "args": ["mcp"]
    }
  }
}

HTTP/SSE Transport

adb-tui mcp --transport http --addr :8080

All 120+ MCP Tools

Expand full tool list

Category	Tools
Devices	list_devices device_info connect disconnect get_device_state is_rooted remount
Shell	shell root unroot
Packages	list_packages install_apk uninstall_package package_info force_stop clear_data enable_package disable_package grant_permission revoke_permission
Files	push_file pull_file list_files read_file write_file delete_file mkdir stat_file find_files disk_usage chmod chown
Screen	screenshot screen_record get_screen_size
Logcat	logcat clear_logcat
Input	tap swipe key_event input_text long_press human_swipe
UI Automation	get_ui_hierarchy find_element tap_element wait_for_element get_focused_app get_current_activity
Properties	get_prop set_prop list_props
Port Forward	forward forward_list forward_remove forward_remove_all reverse reverse_list reverse_remove_all
Intent	start_activity send_broadcast open_url
Activity	get_current_activity list_activities
System	reboot get_battery
Connectivity	wifi_control get_ip_address get_network_info tcpip_mode usb_mode ping_host
Settings	get_setting put_setting list_settings delete_setting
Device Control	screen_on screen_off is_screen_on get_brightness set_brightness set_rotation set_auto_rotation get_airplane_mode set_airplane_mode
Volume & Media	volume_up volume_down volume_mute media_play media_pause media_next media_previous
Display	set_display_size reset_display_size set_density reset_density get_font_scale set_font_scale
Notifications	list_notifications expand_notifications collapse_notifications expand_quick_settings
Process	list_processes kill_process kill_process_by_name top_processes memory_info app_memory_info
Dumpsys	dumpsys dumpsys_list battery_info display_info window_info
Security	selinux_status set_selinux list_permissions get_apk_path
Testing	run_monkey run_instrumentation
Battery Sim	simulate_battery reset_battery
Backup	bugreport sideload backup restore
Network	netstat
Clipboard	get_clipboard set_clipboard

CLI Commands

Use adb-tui as a scriptable CLI without launching the TUI:

adb-tui devices                           # List connected devices
adb-tui shell <serial> <command>          # Run shell command
adb-tui screenshot <serial> output.png    # Capture screenshot
adb-tui install <serial> app.apk         # Install APK
adb-tui mcp                              # Start MCP server (stdio)
adb-tui version                          # Print version info

Configuration

Optional. Place at ~/.config/adb-tui/config.json:

{
  "adb_path": "/usr/local/bin/adb",
  "theme": "default"
}

Available themes: default, nord, tokyonight, catppuccin. You can also switch themes in-app by pressing T.

Use Cases

• Android app debugging: stream logcat, inspect UI hierarchy, toggle settings without leaving the terminal
• Device fleet management: connect multiple devices, query battery/storage/network in one dashboard
• Automated testing: run monkey tests, drive UI with tap_element/find_element, capture screenshots
• AI-powered device control: pair with Claude or any MCP client to build autonomous Android workflows
• Remote device inspection: wireless ADB + HTTP/SSE transport for headless or CI environments
• Reverse engineering: browse filesystem, dump window info, inspect running processes and permissions

Architecture

cmd/adb-tui/       CLI entry point (cobra)
internal/adb/       ADB client library, parameterized, concurrent, tested
internal/tui/       Bubbletea TUI, 11 views, Elm architecture
internal/mcp/       MCP server, 120+ tools, stdio + HTTP/SSE transport
internal/config/    Configuration management
pkg/jsonrpc/        JSON-RPC 2.0 implementation

Contributing

Contributions are welcome. See CONTRIBUTING.md for guidelines.

make check    # fmt, vet, lint, test with race detector
make ci       # full CI pipeline with coverage gate

License

Apache-2.0 © Alan