by ghorbelhamdi
A floating chat bubble that lets Claude Code, Codex or OpenCode use your Android phone. Runs inside the app on your own subscription or free models. No adb, no PC, no root.
# Add to your Claude Code skills
git clone https://github.com/ghorbelhamdi/buddy-androidGuides for using ai agents skills like buddy-android.
See how buddy-android compares with popular alternatives.
buddy-android is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by ghorbelhamdi. A floating chat bubble that lets Claude Code, Codex or OpenCode use your Android phone. Runs inside the app on your own subscription or free models. No adb, no PC, no root. It has 50 GitHub stars.
buddy-android's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/ghorbelhamdi/buddy-android" and add it to your Claude Code skills directory (see the Installation section above).
buddy-android is primarily written in Java. It is open-source under ghorbelhamdi on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh buddy-android against similar tools.
No comments yet. Be the first to share your thoughts!
Unlocks once the catalog security scan passes (runs nightly).
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
A floating chat bubble that lets Claude Code, Codex or OpenCode use your Android phone.
Type or say what you want ("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 you before anything that sends, posts, buys or deletes.
It runs on your own subscription: Claude Code with your Claude plan, Codex with your ChatGPT plan, or OpenCode with its free models and no account at all. Everything runs inside the app, in Buddy's own small Linux on the phone: no PC, no adb, no root, no API key.
https://github.com/user-attachments/assets/6659a546-9bbd-4adf-bb42-d924cf58e98e
Turning on the lights, then a pizza order changed mid-task (sped up)
Status: 2.1, 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.
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:
Buddy app / bubble ──► Buddy's Linux (Alpine via proot): buddy-run ──► claude -p, codex exec or opencode run
▲ │
└────────────── streamed replies (POST /event) ◄───────────────────┤
▼
Buddy accessibility service ◄──── MCP over http://127.0.0.1:8765/mcp (phone tools)
read_screen, tap, long_press, type_text, scroll, swipe, press, open_app, list_apps, open_url, screenshot, wait, install_apk, wait_for_install, confirm, ask, notify and update_buddy.You need a 64-bit Android 11+ phone and a Claude Pro/Max plan (or a ChatGPT plan for Codex). With OpenCode you don't need any plan: its free models work right away.
| Step | What happens |
|---|---|
| Choose your agent | Claude Code (recommended), Codex, OpenCode (free models, no account), or Claude Code and Codex together |
| Accessibility | Turn on Buddy assistant. Greyed out ("Restricted setting")? App info → ⋮ → Allow restricted settings, then try again |
| Install and sign in | One tap installs your agent in Buddy's Linux (Claude Code about 235 MB, Codex about 150 MB, OpenCode about 230 MB; use Wi-Fi). OpenCode needs no sign-in; its providers can be connected later with Connect a provider, which runs opencode auth login in Buddy's terminal. For the others, Sign in: your browser opens, you approve, and Buddy comes back by itself. For Claude, Buddy picks the one-time code off the confirmation page for you. No browser on this phone you want to use? Sign in on another device (Claude: a link to open anywhere) or Sign in with a code (Codex) |
| Keep it running | Battery: unrestricted for Buddy |
| Try it | A first chat with a ready-made prompt |
Android blocked the install? Play Protect may say "App blocked to protect your device" for apps that use Accessibility and come from a browser: tap More details → Install anyway (or install from a file manager). On Android 13+, if Buddy assistant is greyed out in Accessibility, open App info → ⋮ → Allow restricted settings first.
Buddy is in closed testing on Google Play; the full version (with self-updates and developer mode) comes from GitHub Releases. Every release is signed with the same key, so installing a new APK over the old one keeps your chats, settings, sign-ins and Buddy's Linux. Don't uninstall first: that deletes them.
Ask Buddy: "Is there a Buddy update?" or "Update yourself." The agent checks the latest release, tells you what's new, and with your OK downloads buddy.apk from this repo's releases and opens Android's installer; you tap Update.
Automatic updates with Obtainium (free, open source; it checks GitHub for you and installs new versions):
https://github.com/ghorbelhamdi/buddy-android, then Add.buddy.apk and buddy-vX.Y.Z.apk). If Obtainium asks which one, pick buddy.apk. To never be asked, set Filter APKs by regular expression to ^buddy\.apk$ in the app's settings in Obtainium.By hand: open the latest buddy.apk on the phone and install it over the current one. To get an email for each new version, sign in to GitHub and choose Watch → Custom → Releases on the repository.
The agents (Claude Code, Codex, OpenCode) update separately: Settings → the agent → Check for updates. An OpenCode 1.x install gets Update to OpenCode 2 there; your connected providers are kept.
The app has three tabs: Chats, Sessions and Settings.