Updated 1d ago
by niki914
zafiro
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.
259 GitHub stars (259)
+46 in 16 days
| Period | New stars |
|---|---|
| Oct 1 | 0 |
| Oct 2 | 0 |
| Oct 3 | +1 |
| Oct 4 | +3 |
| Oct 5 | +3 |
| Oct 6 | +4 |
| Oct 7 | +3 |
| Oct 8 | 0 |
| Oct 9 | +4 |
| Oct 10 | +3 |
| Oct 11 | +6 |
| Oct 12 | +3 |
| Oct 13 | +4 |
| Oct 14 | +4 |
| Oct 15 | +6 |
| Oct 16 | +2 |
- 11 skills (11 skills found in its SKILL.md files)
- 40 forks (40 forks)
- 1d ago last update (Last updated 1d ago)
Install
Skills CLI
npx skills add niki914/zafiro
Asks which skills and agents to install. Just one: npx skills add niki914/zafiro --skill add-worktree — add -g for every project.
Claude Code
git clone https://github.com/niki914/zafirocp -r "zafiro/.agents/skills/add-worktree" ~/.claude/skills/
Copies the add-worktree skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add niki914/zafiro
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
add-worktree
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". Names the branch from the request and creates `<repo parent>/zafiro-worktrees/<branch>` off origin/main.
.agents/skills/add-worktree/SKILL.md on GitHub (opens in a new tab) -
eli5
Transform technical jargon into clear explanations using before/after comparisons, metaphors, and practical context
.agents/skills/eli5/SKILL.md on GitHub (opens in a new tab) -
grill-me
A relentless interview to sharpen a plan or design.
.agents/skills/grill-me/SKILL.md on GitHub (opens in a new tab) -
grill-with-docs
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
.agents/skills/grill-with-docs/SKILL.md on GitHub (opens in a new tab) -
handoff
Compact the current conversation into a handoff document for another agent to pick up.
.agents/skills/handoff/SKILL.md on GitHub (opens in a new tab) -
prompt-engineering
Guidelines to writing prompts, docs, or tasks for AI to read or execute, with strict context isolation.
.agents/skills/prompt-engineering/SKILL.md on GitHub (opens in a new tab) -
release-new-version
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).
.agents/skills/release-new-version/SKILL.md on GitHub (opens in a new tab) -
show-me
Help the user understand the current topic visually with concise diagrams, code-shape sketches, and focused HTML artifacts.
.agents/skills/show-me/SKILL.md on GitHub (opens in a new tab) -
writing-for-agents
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
.agents/skills/writing-for-agents/SKILL.md on GitHub (opens in a new tab) -
Phone Use
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 operation, load this skill first.
app/src/main/assets/skills/phone-use/SKILL.md on GitHub (opens in a new tab) -
Termux
Load this skill for anything involving Termux (com.termux) — first-time SSH setup, connecting to Termux, or a Termux connection that stopped working.
app/src/main/assets/skills/termux/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.