Releases: noskinodesign/codex-usage-panel-skill
Release list
v0.1.6 - Preserve local avatar on reinstall
What's changed
- Preserves local profile avatar assets referenced by ~/.codex-usage-panel/profile.json during reinstall.
- Prevents ./profile-avatar.png from being deleted when refreshing dashboard assets.
Why
Reinstalling the panel refreshes assets/, but users may keep profile.json with avatarUrl pointing to a local avatar file. This release keeps that local avatar file in place.
Verification
- node --check scripts/install-panel.mjs
- node --check scripts/sync-usage.mjs
- Skill quick validation
- Reinstall test preserving ./profile-avatar.png
- Release zip rebuilt
v0.1.5 - Stable panel ports
What's changed
- Stops existing Codex usage panel LaunchAgents before choosing a port, so reinstalling no longer accidentally drifts from 8765 to 8766 just because the previous service was still running.
- Keeps the previous dashboard port alive as a macOS compatibility alias when the active port changes.
- Adds --alias-port and --alias-ports for explicit old-link compatibility.
- Disables early prototype com.lukeji.codex-usage-panel-* LaunchAgents during install, with --keep-legacy-launch-agents as an escape hatch.
Why
Old Codex conversation links can point to a previous local port. This release prevents those links from becoming dead after repair/reinstall.
Verification
- node --check scripts/install-panel.mjs
- node --check scripts/sync-usage.mjs
- Skill quick validation
- Temporary install with --alias-port and local avatar file
- Release zip contents verified
v0.1.4 - Local avatar file support
What's changed
- --profile-avatar now accepts local image files as well as image URLs.
- Local avatar files are copied into the installed panel assets folder and served from 127.0.0.1.
- Documentation now shows local avatar setup for exact profile display.
Why
Codex's local app-server exposes account email and plan, but not the ChatGPT display nickname or avatar URL. This release makes exact profile setup reliable for GitHub installs.
Verification
- node --check scripts/install-panel.mjs
- node --check scripts/sync-usage.mjs
- Skill quick validation
- Temporary install with local avatar file
- Local reinstall on port 8765 with profile override
v0.1.3 - Cache refresh fix
What's changed
- Bumps dashboard asset cache keys so upgraded installs load the latest profile renderer immediately.
- Helps existing local browser tabs stop showing stale Codex User / Local account UI after reinstall.
Verification
- Skill quick validation
- Local reinstall on port 8766
- Manual sync confirmed profile is no longer the default
v0.1.2 - Profile detection
What's changed
- Reads local Codex account metadata through account/read when available.
- Generates a personalized display name, handle, and initials avatar instead of showing the shared default profile.
- Supports exact profile overrides through ~/.codex-usage-panel/profile.json.
- Adds installer flags: --profile-name, --profile-handle, and --profile-avatar.
- Updates the panel renderer to use synced profile.avatarUrl with a safe fallback.
Verification
- node --check scripts/sync-usage.mjs
- node --check scripts/install-panel.mjs
- node --check assets/panel/panel.js
- Skill quick validation
- Temporary install and sync test
- Profile override install and sync test
v0.1.1
Adds optional auto-open support for Codex usage panel.\n\n- New install-auto-open-hook.mjs script\n- Installs a local Codex SessionStart hook\n- Opens the usage panel when Codex starts or resumes a conversation\n- Documents enable/remove commands\n- Includes the hook installer in the release zip
v0.1.0
Initial release of Codex Usage Panel Skill.\n\n- Local Codex usage dashboard\n- Near-real-time sync from Codex desktop app-server\n- Remaining usage progress bars and reset times\n- 26-week Token activity heatmap\n- Root-level Codex Skill layout\n- Release zip for direct installation