ghorbelhamdi

Buddy Android — Communication skill for Claude Code

Communication community

A floating chat bubble that lets Claude Code or Codex use your Android phone.

How to install Buddy Android

This entry records only its repository, not the path inside it, so there is no exact command to give. Open ghorbelhamdi/buddy-android and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Buddy Android does

A floating chat bubble that lets Claude Code or Codex use your Android phone. Runs on your own subscription in Termux. No adb, no PC, no root.

Alternatives in Communication

  • Lark Coding Agent Bridge — Bot that bridges Feishu/Lark messenger with a local Claude Code or Codex CLI 2.4k ★
  • Agentrove — A self-hosted web and macOS desktop app for Claude Code and Codex, powered by ACP 270 ★
  • Wechat Exporter — A Claude Code / Codex skill to export and decrypt WeChat (macOS) chat history into plaintext SQLite databases 208 ★

README

Buddy

**A floating chat bubble that lets Claude Code (or Codex) use your Android phone.**

Type a request into the bubble ("reply to Sam that I'm running late", "add a Nintendo Switch 2 to my Amazon cart") and Buddy reads the screen, taps, types and scrolls to get it done. It asks for your approval before anything that sends, posts, buys or deletes.

Buddy runs on **your own subscription**: [Claude Code](https://docs.claude.com/en/docs/claude-code) with your Claude plan, or OpenAI's Codex CLI with your ChatGPT plan, both running in [Termux](https://termux.dev) on the phone. The app has no API key, no server and no account of its own.

**[⬇ Download the APK](https://github.com/ghorbelhamdi/buddy-android/releases/latest/download/buddy.apk)** (Android 11+)

**Status: 1.0, early.** It works well day to day but still has rough edges. Tested on a OnePlus 12 (OxygenOS, Android 16); other Android 11+ phones should work, but may need battery settings adjusted.

Buddy is an independent project. It is not made by or affiliated with Anthropic or OpenAI.

Not another adb setup

Most "AI controls my phone" projects drive the phone over adb, which needs a computer or Wireless debugging that drops all the time. Buddy doesn't use adb at all:

  • It's a normal Android app with an accessibility service, the same kind of permission screen readers use.
  • No adb, no Wireless debugging, no PC, no root.
  • Works without Wi-Fi and comes back on its own after a reboot.

How it works

Buddy app / bubble ──RUN_COMMAND──► Termux: buddy-run ──► claude -p  or  codex exec
        ▲                                                       │
        └──────────── streamed replies (POST /event) ◄──────────┤
                                                                ▼
Buddy accessibility service ◄─── MCP over http://127.0.0.1:8765/mcp (phone tools)
  • The accessibility service draws the bubble and runs a small local MCP server with the phone tools: `read_scree