Open-source BYOK AI agent for Android. Full phone control, native Shell & Python 3, with Skills and MCP support. Built with Material 3 Expressive. Works via Shizuku (root optional). Bring any provider: OpenRouter, Ollma, and more.
This repository also configures its own agents. See what zafiro tells them →
Skill Claude CodeCodex
Use when the user wants to release a new Zafiro version — drafting bilingual release notes, deciding the next version number, bumping app/build.gradle.kts, tagging, and publishing to GitHub (main repo, optionally the Xposed repo).
Skill Claude CodeCodex
MUST Load this skill for ANY task that involves GUI interaction or device control — opening apps, tapping, typing, scrolling, swiping, Back/Home/Recents, reading the screen, or any workflow that touches on-screen content. Load this even when the user does not explicitly mention the device — if the task implies a GUI…
Skill Claude CodeCodex
A relentless interview to sharpen a plan or design.
Skill Claude CodeCodex
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
Skill Claude CodeCodex
Compact the current conversation into a handoff document for another agent to pick up.
Skill Claude CodeCodex
Guidelines to writing prompts, docs, or tasks for AI to read or execute, with strict context isolation.
Skill Codex
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
Skill Claude CodeCodex
Use when the user wants to start work in a new git worktree — "new worktree", "spin up a worktree/branch for this", "work on X in another worktree", "branch this off". Allocates a reusable slot ( /worktrees/zafiro/slot-X) off origin/main with a meaningful branch name.
Skill Claude CodeCodex
Load this skill for anything involving Termux (com.termux) — first-time SSH setup, connecting to Termux, or a Termux connection that stopped working.
Skill Claude CodeCodex
Install a skill from a public GitHub repository onto this device. Use whenever the user pastes a GitHub URL or names a repo and wants a skill installed, imported, or updated, or asks to add a skill from GitHub — even if they only send a link. Covers finding SKILL.md in a repo, downloading it with python, and placing…
Skill Claude CodeCodex
Create new skills, modify and improve existing skills, and measure skill performance. Use whenever the user wants to create a skill from scratch, turn a workflow or repeated task into a skill, edit or optimize an existing skill, test a skill with realistic prompts, or tune a skill's description so it triggers reliably…
Skill Claude CodeCodex
Use before writing, adding, or modifying any unit test in this repo — before creating a Test.kt file or a @Test function, and before touching an existing test after a refactor. Triages whether the test should exist at all, and what must happen to it when the code it guards changes.
Skill Claude CodeCodex
A workflow for adapting an Android voice assistant integration to a new app version. It examines the updated app package, checks whether the integration points changed, and creates and verifies a matching configuration.
Skill Claude CodeCodex
A workflow for finding an Android app on a connected device, exporting its APK, and turning it into searchable decompiled source files. An APK is the installable package used by Android apps.
Skill Claude CodeCodex
Prevent and diagnose hanging or long-running Gradle unit tests (> 30s) in Android/Kotlin coroutines codebases. Use when running tests, when a test execution takes unexpectedly long, when background test tasks appear frozen, or when taking thread dumps (jstack) to unblock coroutine deadlocks.
Skill Claude Code
Turns an answer into a one-page visual HTML explainer: the model writes a short Markdown draft and the bundled CLI builds one page. Use it proactively and liberally, without being asked, whenever a page would help the reader more than plain text, even if plain text would also work: any explanation of how something…
Skill Claude CodeCodex
A workflow for analysing short recordings of a single user-interface animation. It creates frame grids and motion-trail comparisons so the interaction can be studied visually.
Skill Claude CodeCodex
Read or change Zafiro's own settings by editing the JSON files in its sandbox. Use this whenever the user asks to see, explain, change, add or remove Zafiro configuration — agent profiles, execution rules, takeover rules, MCP servers, custom Python tools, text actions, saved LLM configs, or app preferences such as…
Skill Claude CodeCodex needs its repo
An Android quality-assurance workflow for testing the Zafiro app on a real phone or emulator. It uses one installed app as the test controller and a separate debug app as the app under test, with screenshots, device actions, settings, and logs.
At most 3 mods per repository are shown here, and a mod shipped inside a plugin is left to that plugin's page — the rest are on their repository pages: