alanisme/adb-tui

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.

? 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

CLI Commands

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

adb-tui devices                           # List connected devices
adb-tui shell            # Run shell command
adb-tui screenshot  output.png    # Capture screenshot
adb-tui install  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