Changelog

0.1.7 - 2026-09-07

Make the auto-open hook follow the installed panel's current port, including automatic port selection and later port changes
Support --root for auto-open with a custom panel install directory while preserving explicit URL overrides
Refresh the project preview with the author's September 2026 dashboard screenshot and clarify that bundled data is generic
Add direct release links and upgrade instructions to the English and Chinese README
Include the preview image, changelog, and packaging script in the release zip so extracted documentation and repackaging work

Preserve local profile avatar assets referenced by profile.json during reinstall
Prevent ./profile-avatar.png from being deleted when refreshing dashboard assets

Stop existing panel LaunchAgents before selecting a port, avoiding accidental fallback to a new port during reinstall
Keep the previous dashboard port as a macOS compatibility alias when the active port changes
Added --alias-port / --alias-ports for explicit old-link compatibility
Disable early prototype com.lukeji.codex-usage-panel-* LaunchAgents during install, with --keep-legacy-launch-agents as an escape hatch

Let --profile-avatar accept local image files and copy them into the installed panel assets
Documented local avatar file setup for exact profile display

Bumped dashboard asset cache keys so upgraded installs load the latest profile renderer immediately

Added local Codex account metadata sync through account/read
Derived a personalized display name, handle, and initials avatar when ChatGPT nickname/avatar are not exposed locally
Added ~/.codex-usage-panel/profile.json and installer flags for exact profile name, handle, and avatar overrides
Updated the panel renderer to use synced profile.avatarUrl

Added optional Codex SessionStart hook installer for auto-opening the usage panel in new or resumed conversations
Documented how to enable and remove auto-open behavior
Included the auto-open hook installer in the release zip

Initial shareable Codex Skill release
Local dashboard with profile, remaining usage, token activity, and summary stats
Near-real-time sync from the Codex desktop app server
macOS LaunchAgent installer
Automatic fallback when the default local port is busy
Root-level Skill repository layout for direct git clone installation