Skip to content

v1.0.4

Choose a tag to compare

View all tags
@bittired bittired released this 13 Apr 12:47
· 1 commit to main since this release
1.0.4
eecf9c0
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

What's New

Install or upgrade with the one-liner:

curl -fsSL https://get.phonebase.cloud | sh

Verify afterwards:

pb --version
pb skills install

Device Control

  1. pb install supports local files, URLs, and XAPK — Install apps from a local APK/XAPK file, an HTTP URL, or a device path. Large files show a real-time progress bar with speed and ETA. Example: pb install ~/Downloads/app.xapk
  2. pb push uploads files to the device — Push local files with --dest for custom paths, or pass a URL to let the device download directly. Example: pb push photo.jpg --dest /sdcard/Pictures/
  3. Smart error recovery — Missing arguments, invalid paths, and interrupted transfers give clear suggestions. Partial uploads are cleaned up automatically

New Commands

  1. pb daemon status/stop/restart/logs — Full daemon lifecycle management. Check connection status, restart after issues, or tail the log file for debugging
  2. pb skills new <name> — Scaffold a new skill interactively: pick the target app from a live device list, auto-extract the app icon, pre-fill package name and category
  3. pb icon <package> — Show any installed app's launcher icon in the terminal

Skills

  1. pb skills install <name> from the skill hub — Install skills by name with automatic dependency resolution. Example: pb skills install googleplay pulls GooglePlay + its dependency GoogleServices in one command
  2. pb skills list shows icons, versions, and status — Visual skill overview at a glance: app icon, enabled/disabled state, version, and description
  3. Streaming install progress — Watch installs happen in real time: ↓ downloaded, → found dependency, ✓ installed
  4. Remote skill templates — pb skills new pulls the latest templates automatically — no CLI update needed to get template improvements

UI

  1. App icons everywhere — pb packages and pb skills list now display launcher icons inline (iTerm2 / Kitty) with colored letter fallback in other terminals
  2. Cleaner pb list output — Commands already available as aliases are hidden, giving you a focused view of what's actually useful
  3. Reorganized pb --help — Commands grouped into Device Management, Device Control, Skills, and Connection sections
  4. Seamless upgrades — pb update automatically restarts the daemon so the new version takes effect immediately

Connection

  1. Idle timeout — Auto-disconnects after 10 minutes of inactivity to save resources. Configure with pb config set idle_timeout <seconds>
  2. Faster sequential commands — Reduced overhead when running multiple pb commands in a row (e.g., AI agent workflows)
  3. More reliable connections — Rearchitected CLI-to-device communication for better stability under load

Config

  1. Underscore-style config keys — network_timeout, idle_timeout (old dash-style keys removed)

更新内容

一键安装或升级：

curl -fsSL https://get.phonebase.cloud | sh

验证安装：

pb --version
pb skills install

设备控制

  1. pb install 支持本地文件、URL 和 XAPK — 本地 APK/XAPK、HTTP 链接、设备路径三种方式安装应用，大文件实时显示进度条和预估时间。示例：pb install ~/Downloads/app.xapk
  2. pb push 上传文件到设备 — 本地文件用 --dest 指定目标路径，也可传 URL 让设备直接下载。示例：pb push photo.jpg --dest /sdcard/Pictures/
  3. 智能错误恢复 — 缺参数、路径不存在、传输中断都给出清晰的操作建议，失败时自动清理残留文件

新增命令

  1. pb daemon status/stop/restart/logs — 完整的守护进程管理：查看连接状态、重启、查看日志
  2. pb skills new <name> — 交互式创建 skill：从已连接设备的应用列表中选择目标应用，自动提取图标，预填包名和分类
  3. pb icon <package> — 在终端显示任意已安装应用的图标

Skills

  1. pb skills install <name> 从 skill hub 安装 — 按名字安装 skill，自动解析依赖。示例：pb skills install googleplay 一条命令拉取 GooglePlay 及其依赖 GoogleServices
  2. pb skills list 展示图标、版本和状态 — 一览：应用图标、启用/禁用状态、版本号、描述
  3. 流式安装进度 — 实时看到安装过程：↓ 下载、→ 发现依赖、✓ 安装
  4. 远程 skill 模板 — pb skills new 自动拉取最新模板，不需要更新 CLI 就能获得模板改进

界面

  1. 应用图标随处可见 — pb packages 和 pb skills list 都内联显示应用图标（iTerm2 / Kitty），其他终端用彩色首字母代替
  2. 更干净的 pb list 输出 — 已被别名覆盖的命令自动隐藏，只显示真正需要关注的接口
  3. pb --help 分类重组 — 按设备管理、设备操作、Skills、连接分组，快速找到需要的命令
  4. 无缝升级 — pb update 自动重启守护进程，新版本立即生效

连接

  1. 空闲超时 — 10 分钟无操作自动断连以节省资源，可配置：pb config set idle_timeout <秒数>
  2. 连续命令更快 — 连续执行多条 pb 命令时开销更低（AI agent 工作流受益明显）
  3. 连接更稳定 — 重新设计了 CLI 到设备的通信架构，高负载下更可靠

配置

  1. Config key 统一下划线风格 — network_timeout、idle_timeout（不再支持横杠风格）
Assets 7
Loading