What's Changed
📝 Documentation Improvements
- Added critical warning about bunx requiring
@latestsuffix for@ccusage/codex - Documented ccusage family of tools (ccusage, codex, mcp) in README
- Added shell alias recommendation for codex (
ccusage-codex) - Updated installation examples across documentation
⚠️ Important for bunx users with @ccusage/codex
When using bunx with @ccusage/codex, you MUST include the @latest suffix:
bunx @ccusage/codex@latest # ✅ Correct
bunx @ccusage/codex # ❌ May run wrong binaryWhy? Bun 1.2.x's bunx prioritizes binaries matching the package name suffix. For @ccusage/codex, it looks for a codex binary in PATH first. If you have an existing codex command (e.g., GitHub Copilot's codex), that will be executed instead.
💡 Recommended Shell Alias
Since the command is long, we recommend setting up an alias:
# bash/zsh: alias ccusage-codex='bunx @ccusage/codex@latest'
# fish: alias ccusage-codex 'bunx @ccusage/codex@latest'For more details about major features and breaking changes, see the v17.0.0 release notes.