claude-statusline-powerline

Claude Statusline Powerline enhances the Claude Code interface with a customizable powerline-style statusline displaying real-time development metrics. The tool integrates with git to show branch status and file changes, tracks active session tokens and estimated costs, and monitors context usage with cache performance data. Developers can configure multiple visual themes (dark, dracula, nord, tokyo-night, and more), customize segment order across multiple lines, and enable IntelliSense for settings validation. It supports Nerd Font and powerline font profiles with adjustable separators and icons, helping developers maintain workflow awareness without leaving the Claude Code environment.

[{"step":"Install the dependency in your project","action":"Run `npm install @claude/statusline-powerline` in your project root. Ensure you're using TypeScript 5.0+ and have a `.claude` directory in your project.","tip":"Check your project's `package.json` for existing dependencies to avoid version conflicts."},{"step":"Create the configuration file","action":"Generate `.claude/statusline.ts` using the template above. Customize the segments (git, session, cost) based on your workflow needs. Use the theme colors that match your terminal's color scheme.","tip":"Start with minimal segments (git + session) and add cost tracking later to avoid visual clutter."},{"step":"Configure Claude to load the statusline","action":"Edit your project's `claude.json` to include: `\"statusline\": \".claude/statusline.ts\"`. Restart Claude Code to apply changes.","tip":"Use `claude --version` to verify the statusline module is loaded. Check the debug console for any TypeScript compilation errors."},{"step":"Customize and extend segments","action":"Add custom segments by extending the Statusline class. For example, add a [LINT_ERRORS] segment that shows ESLint results or a [TEST_STATUS] segment that displays Jest coverage.","tip":"Use the `statusline.on('update', callback)` event to refresh segments asynchronously. Log segment updates to the console during development."},{"step":"Share configuration with your team","action":"Commit the `.claude/statusline.ts` and `claude.json` changes to your project repository. Document any custom segments in your project's README.","tip":"Include a screenshot of your statusline in the README to help team members visualize the setup."}]