buddy-android README

项目的 README,来自 github.com/ghorbelhamdi/buddy-android。合并为一个 markdown 文件:README.md。

Buddy: Claude Code, Codex, OpenCode, Antigravity and Grok in a bubble on your Android phone

Latest release Downloads Buddy on F-Droid Android 11+ Buddy on Product Hunt Buddy MCP server on Glama License: Apache-2.0

Buddy

A floating chat bubble that lets Claude Code, Codex, OpenCode, Antigravity or Grok use your Android phone.

Type or say what you want, like "reply to Sam that I'm running late" or "add a Switch 2 to my Amazon cart". Buddy reads the screen, taps and types to get it done, and asks you before anything is sent, posted, bought or deleted.

It runs inside the app, on your own plan: Claude Code with your Claude plan, Codex with your ChatGPT plan, Google's Antigravity CLI with your Google account, xAI's Grok Build with your Google or X account, or OpenCode with its free models and no account at all. No PC, no adb, no root, and no API key needed (you can add keys for other services, such as DeepSeek or OpenRouter, and use them with Claude Code, Codex or OpenCode).

Download the APK · F-Droid · Website · Android 11+, 64-bit

https://github.com/user-attachments/assets/d07936fc-4788-4ab5-a105-31b3e9aeba4f

Codex turns on the lights while OpenCode's free model adds a Switch 2 to the Amazon cart (real recordings, waiting sped up)

Chats with different agents
Chats with any agent
A chat with grouped tool calls
Tool calls fold into one line
Settings
Setup guide and themes

What it can do

Uses your apps Messages, shopping, smart home, settings: anything on screen. Add instructions while it works.
Asks first Approve, Deny or Change before anything is sent, posted, bought or deleted.
Shows you how "Show me how to turn on dark mode": it points at each step and waits for your tap.
Acts on notifications "When a customer asks on WhatsApp, reply with our opening hours", with your OK, a countdown you can stop, or right away.
Voice Talk to it and have replies read aloud.
Background mode The agent works in your apps on a screen of its own that you don't see, while you keep using your phone. Set up once with the phone's own Wireless debugging, no computer; watch it live in the chat. Optional: let it run adb shell commands on the phone, each one approved by you.
Sub-agents "Compare this on eBay, Amazon and AliExpress": the agent starts sub-agents that each work in an app on a hidden screen of their own, at the same time, and report back. They only look things up; you see every screen in the chat.
Background browser Web pages in a browser inside Buddy, without taking over your screen, even while the phone is locked. Watch and use it live in the chat; it marks what you need to do (sign in, a captcha) and never types your passwords.
Builds apps Turn on Linux tools in a chat and "make me a calculator app" builds a real APK on the phone; the GitHub version also installs it for you.
Phone tools anywhere The same tools as a local MCP server for your own Claude Code, Codex, OpenCode, Antigravity or Grok sessions, or over stdio with mcp-bridge for clients that start servers as commands.

Three sub-agents comparing a price on eBay, Amazon and AliExpress at the same time
Three sub-agents, three shops, at the same time (30 s video)

Status: 2.3, early. It works well day to day but has rough edges. Tested most on a OnePlus 12 (Android 16). Buddy is an independent project, not made by or affiliated with Anthropic, OpenAI, Google or xAI.

How it works

Buddy app / bubble ──► Buddy's Linux (Alpine via proot): claude, codex, opencode, agy or grok
        ▲                                                     │
        └──────────── streamed replies ◄──────────────────────┤
                                                              ▼
Buddy accessibility service ◄──── MCP on 127.0.0.1 (phone tools)

Buddy is a normal Android app with an accessibility service, the kind of permission screen readers use. The agent runs in a small Linux inside the app and uses Buddy's phone tools (read the screen, tap, type, scroll, open apps) over a local MCP server. No adb or Wireless debugging, and it works without Wi-Fi.

Setup

You need a 64-bit Android 11+ phone, plus a Claude, ChatGPT or Google account for those agents (Grok: a Google or X account). OpenCode's free models need no account.

  1. Install Buddy: download buddy.apk and open it, or get it from F-Droid. The APK updates itself; on F-Droid each version arrives a few days later, and F-Droid updates it for you. Both are the same app with the same signature, so you can switch between them without reinstalling. Buddy also installs the apps it builds for you. (Google Play turned Buddy down for production: its policy doesn't allow apps that use accessibility to carry out tasks.)
  2. Follow the setup guide that opens on first launch: pick your agent, turn on the accessibility service, install and sign in, and try a first task.

Install blocked or "Restricted setting"? See Setup in detail.

Local models

Run the model on your own computer and nothing goes to an AI company. Start Ollama, LM Studio or llama.cpp's server on a PC (for Ollama, set OLLAMA_HOST=0.0.0.0 and a context of at least 24k tokens, e.g. OLLAMA_CONTEXT_LENGTH=24576, since the phone tools take about 7k). In Buddy, pick Local model in the setup guide (Settings → the setup card → Open the step-by-step guide opens it again later): it sets up OpenCode, asks for your server and makes it the default for OpenCode's chats. Or add it by hand: Settings → Agents and models → API keys → Add API key → Ollama (or LM Studio, llama.cpp). Either way, put the PC's address on your Wi-Fi instead of localhost and leave the key empty. Plain http:// works on your own network and over Tailscale.

What to expect, from tests on an RTX 2060 Super (8 GB): Qwen3 8B and Qwen3 4B handle simple one-step requests, like the battery level or the phone's status. Multi-step tasks on the screen are another matter: in a calculator test the 4B tapped the wrong buttons and then said it had worked. For real tasks, use a bigger model that's good at tool calling. The first answer of a chat takes longest, since the model first reads about 13k tokens of instructions and tool descriptions. A model running on the phone itself works too, but it's slow and makes the phone lag.

Updating

Install the new APK over the old one: chats, settings and sign-ins stay (don't uninstall first). You can also ask Buddy to "update yourself", or let Obtainium or F-Droid do it (how).

Security

An accessibility service is powerful, so please read this.

More in Security in detail. Found a problem? Please open a private security advisory instead of a public issue.

FAQ

What does it cost? Buddy is free. The agent uses your plan's limits, or nothing at all with OpenCode's free models (no account) or Antigravity's free plan (Google account).

iPhone? No. iOS doesn't let apps operate other apps.

Which phones? 64-bit Android 11 or newer. On some brands, set Buddy's battery use to Unrestricted.

Does it need a computer, adb or root? No.

Learn more

In the press: ProPakistani, The Neutral, Trendshift (October 2026)

Contributing

Bug reports, ideas and translation fixes are welcome: see CONTRIBUTING.md. If Buddy is useful to you, a ⭐ helps other people find it.

For developers

git clone --recurse-submodules https://github.com/ghorbelhamdi/buddy-android.git
./gradlew assembleRelease     # Android Studio / Gradle
./build.sh                    # on the phone in Termux, no Gradle → build/buddy-release.apk

proot and libandroid-shmem are git submodules in third_party/ (git submodule update --init in an existing clone). build.sh needs pkg install openjdk-17 aapt2 d8 apksigner python clang make and android.jar from platform-36 at ~/android-sdk/android-36/android.jar. It creates a signing key at ~/.buddy-keys/release.jks on first run: back it up, since updates must be signed with the same key. Gradle release signing reads BUDDY_KEYSTORE and BUDDY_KEYSTORE_PASSWORD (optionally BUDDY_KEY_ALIAS, BUDDY_KEY_PASSWORD). The version lives in BuildInfo.java, and the project layout is in CONTRIBUTING.md.

License

Apache-2.0. Geist fonts: SIL Open Font License. Icons: Material Symbols (Apache-2.0). Bundled proot (GPL-2.0), talloc (LGPL-3.0) and libandroid-shmem (BSD-3-Clause): see third_party for licences and source.

buddy-android (ghorbelhamdi/buddy-android)

正在搜索数据库…

这是什么?Buddy 是 Android 上的一个悬浮聊天气泡,可以让 AI 编程智能体(Claude Code、Codex、OpenCode、Google 的 Antigravity CLI,或 xAI 的 Grok Build)读取手机屏幕、点击和输入,替你完成任务,比如回复消息或把商品加入购物车。
这是一个需要安装的应用,还是要通过 adb 或电脑运行?这是一个普通的 Android 应用,带有无障碍服务;智能体运行在应用内部的一个小型 Linux 环境中,不需要电脑、adb 或 root 权限。
怎么安装和设置?从 Google Play 安装 Buddy(封闭测试,需加入测试组),或直接下载 buddy.apk;首次打开时,设置指南会带你选择智能体、开启无障碍服务、登录,并试运行一个任务。
使用不同的智能体需要什么账号?你需要一部 64 位、Android 11 及以上版本的手机,以及 Claude、ChatGPT 或 Google 账号(具体取决于所用的智能体;Grok 需要 Google 或 X 账号);OpenCode 的免费模型无需任何账号即可使用。
日常使用是否成熟、可靠?它的版本号是 2.2,并标注为“早期”版本。README 中写道,它日常使用效果不错,但仍有一些粗糙的地方,主要在一台运行 Android 16 的一加 12 上测试过。
iPhone 也能用吗?不能,它只支持 Android;iOS 不允许应用像 Buddy 所需要的那样去操作其他应用。
在执行发送消息或购买等有风险的操作前,它会先询问我吗?会。Buddy 自己执行写死的审批规则,而不是交给智能体处理:消息、购物和支付类应用在点击“发送”“支付”或“删除”等按钮前会暂停,直到你点击“批准”“拒绝”或“修改”。
让 AI 智能体控制我的屏幕,主要风险是什么?提示词注入。恶意消息或网页可能会试图向智能体植入隐藏指令。屏幕上的文字被视为不可信内容,而审批卡片是最后一道防线。
我能否在自己的智能体环境中使用 Buddy 的手机控制工具,而不是在应用内使用?可以。同样的手机工具(读取屏幕、点击、输入、滚动、打开应用)以本地 MCP 服务器的形式对外提供,你自己的 Claude Code、Codex、OpenCode、Antigravity 或 Grok 会话都可以连接,包括通过 mcp-bridge 的 stdio 方式连接。
使用它要花钱吗?Buddy 本身免费;使用 Claude、ChatGPT、Google 或 Grok 时,按你现有套餐的额度计费;使用 OpenCode 的免费模型或 Antigravity 的免费层级则完全不花钱。
有哪些类似的项目?Agentlas-OS, mobile-mcp, DSH-Android, andee, t3code, Rungic, aichat, Mika
大小
13.4 MB
星标
288
时长
1个月
提交 · 90 天