ccusage / _consts / PROJECT_ALIASES_ENV
Variable: PROJECT_ALIASES_ENV
ts
const PROJECT_ALIASES_ENV: "CCUSAGE_PROJECT_ALIASES" = 'CCUSAGE_PROJECT_ALIASES';Environment variable for custom project name aliases
Allows users to configure readable display names for cryptic or long project directory names. This is particularly useful for:
- UUID-based project directories generated by Claude Code
- Long path-based project names that are hard to read in tables
- Custom branding of project names for organizational consistency
Format: "raw-name=alias,another-name=other-alias" Example: "a2cd99ed-a586-4fe4-8f59-b0026409ec09=My Project,long-project-name=Short"
Environment variable approach is used because:
- No config file needed - simple and lightweight configuration
- Works in any shell/environment without file management
- Easy to set temporarily for specific invocations
- Follows Unix conventions for tool configuration
- Doesn't require file system permissions or config directory setup
Used to override display names for project directories in all output formats.