v0.1.0 · Notifications and usage

Codex Passport v0.1.0 provides meaningful Codex session notifications and quota visualization on FoloToy AI Passport, with a Material 3 Expressive Android companion.

• Computer BLE direct delivery or Android forwarding over a private LAN/VPN.
• One active BLE owner, phone fallback, durable delivery receipts and offline replay.
• Quota remaining versus time remaining, with visual pace indicators.
• Native Passport button controls and a graphical 240×320 dashboard.

This version displays notifications and bounded summaries. It does not provide conversation continuation, replies, approvals, or other human-in-the-loop controls.

See the repository's validation record for measured results. Off-LAN WireGuard was excluded from this release's acceptance and has not been physically tested; battery endurance has not been measured.

The APK uses a debug signature. Firmware must be written only to the factory app partition at 0x10000 on the documented hardware layout, preserving bootloader, partitions, NVS, cardid and Recovery. See the README before flashing.

Python wheel example:

uvx --from ./codex_passport_sync-0.1.0-py3-none-any.whl codex-passport --help

Direct BLE requires the optional ble dependencies. Source installation: uv sync --extra ble.

Setup guide and Python update

Start with the step-by-step Chinese guide. Python 0.1.1 is now available on PyPI and works with this release's APK and firmware. No device reflash is needed for that documentation/packaging update.