Skip to content

Android Use v0.7.1 — A steadier live screen. Now a Claude Code plugin

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 10 Nov 05:58
v0.7.1
abb0feb
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Android Use v0.7.1

A steadier live screen. Now a Claude Code plugin.

The live phone view no longer restarts its video every time the panel is briefly hidden, an authentication pause can be ended from the panel, and the repository now loads directly as a Claude Code plugin. All 26 MCP tools, keyless host decisions, optional Jev and the existing Dim / Codex integrations are unchanged.

English README · 中文 README · Native installation and rollback · Source upgrades

What's changed

  • The encoder lingers for 30 seconds after the viewer is hidden. Previously capture stopped 5 seconds after the last frame request, so switching away from the panel and back cost a full encoder restart, about 3 seconds of "waiting for a new picture" on the test phone. Frames stop being served as soon as the viewer is hidden, a hidden viewer never starts an encoder, and an authentication pause or a locked phone still stops capture at once.
  • Stopping video no longer blocks frame requests. Phone-side recorder cleanup runs outside the preview lock. It used to hold that lock for up to several seconds, stalling every open panel.
  • One failed lock-state read is not a disconnect. The stream now stops only after three consecutive failures. Tap and swipe are disabled from the first failure until the state is known again.
  • Resume from the panel. During an authentication pause the panel shows 我已完成，恢复预览. It clears the same shared flag as aua_resume, so a pause left behind by a closed agent session no longer strands every preview. A locked phone still resumes only after it is unlocked on the device.
  • Claude Code plugin. .claude-plugin/ adds a plugin manifest and a marketplace entry. The manifest's own MCP entry uses ${CLAUDE_PLUGIN_ROOT}; the existing .mcp.json for Codex and Dim is unchanged. /android-use:screen opens the live screen in a local browser, because the Claude Code terminal cannot embed it. The plugin ZIP includes the manifest and the release check now covers its version.

Preview daemons from earlier versions are replaced automatically, keeping the same local address, the first time the screen is opened after updating.

Install in Claude Code

Requires uv, ADB and ffmpeg on the computer the phone is connected to.

/plugin marketplace add arcships/android-use
/plugin install android-use@arcships

The first start creates the Python environment with uv and needs network access. To load a source checkout or the extracted android-use-0.7.1-plugin.zip instead, start Claude Code with claude --plugin-dir /absolute/path/android-use.

Dim Agent, Codex and other MCP clients install as in v0.7.0; asset names are the same with the new version number.

Validation and scope

  • 487 Python tests and 25 browser tests are in the suite, with Ruff and the UI build. Seven of them are new and cover the lingering encoder, lock-free stop, the lock-probe threshold and panel resume.
  • The preview changes were exercised on one physical phone (Android 16, HyperOS 3, USB): returning to a hidden viewer inside the linger window served a frame immediately without a second encoder start, and no recorder process was left on the phone afterwards.
  • The Claude Code plugin passed claude plugin validate and connected its MCP server when loaded with --plugin-dir on macOS with Claude Code 2.1.321. Installation from the hosted marketplace and Windows / Linux hosts have not been exercised.
  • Native install, upgrade and rollback acceptance was last run for v0.7.0 and has not been repeated for this version before tagging; the release pipeline re-runs its package checks on the v0.7.1 artifacts.
  • While the encoder lingers, the phone keeps recording for up to 30 seconds after the panel is hidden. Frames stay in memory only and are not written to disk.

中文

v0.7.1 让实时手机画面更稳，并新增 Claude Code 插件。26 个 MCP 工具、宿主决策、可选 Jev，以及 Dim / Codex 的集成方式保持不变。

  • 面板隐藏后录屏保留 30 秒。 此前停止取帧 5 秒就会停流，切走再切回要重新起流，测试机上约 3 秒看不到新画面。现在隐藏后立即停止提供画面，隐藏期间不会新启动录屏；认证暂停或手机锁屏仍会立刻停流。
  • 停流不再阻塞取帧。 手机端录屏清理移到预览锁之外执行。
  • 单次锁屏状态读取失败不再判定为断连。 连续 3 次失败才停流；第一次失败起禁用点击和滑动，直到状态恢复。
  • 在面板中恢复。 认证暂停时面板显示「我已完成，恢复预览」，清除的是与 aua_resume 相同的共享标记；手机锁屏仍需在手机上解锁。
  • Claude Code 插件。 新增 .claude-plugin/，原有 .mcp.json 不变。运行 /plugin marketplace add arcships/android-use 和 /plugin install android-use@arcships 安装；/android-use:screen 在本机浏览器中打开实时画面。

验证范围： 套件共 487 项 Python 测试、25 项浏览器测试。预览改动在一台 Android 16 真机上通过 USB 验证；Claude Code 插件在 macOS 上通过清单校验并以 --plugin-dir 加载连接成功，托管市场安装及 Windows / Linux 尚未验证。原生安装、升级和回滚验收最近一次针对 v0.7.0 执行，打标签前未针对本版本重跑。

Assets 14
Loading