oh-my-claude is an extensible statusline framework designed for Claude Code, similar in spirit to oh-my-zsh. It enhances the status bar at the bottom of your terminal, which is blank by default, thereby providing valuable context during development.

With oh-my-claude, session data includes model details, context usage, cost, and git information, all represented in a dynamic and visually appealing manner. The framework employs a series of plugins—small, focused functions—to render specific pieces of information, outputting styled results to the statusline. Themes control the arrangement of these plugins, determining their display order and alignment.

Features

• Dynamic Plugins: Each plugin serves a unique purpose, from displaying raw data to engaging displays like battle-log, which transforms context usage into an interactive dungeon crawl. Other plugins, such as garden, let users visually track progress with an ASCII plant that grows as code is added.

• Creative Themes: Choose from various themes that cater to distinct aesthetics and functionalities:

  • tamagotchi: A playful vibe with a virtual pet and a growing ASCII garden.
  • boss-battle: An immersive experience mimicking a dungeon crawl accompanied by atmospheric music.
  • default: A clean layout that focuses solely on the essentials.

Plugin Ecosystem

With over 41 plugins available, mix and match functionalities to create a personalized experience. Here’s just a sampling:

• tamagotchi: Interacts based on session status, reflecting your virtual pet's mood.
• cat: Introduces whimsical cat behavior during coding sessions.
• context-bar: Displays visual context usage, encouraging productivity with percentage progress indicators.

Build Your Own Plugins

Creating custom plugins is simple. Users can add community plugins or scaffold new ones with the CLI. JavaScript and script-based plugins can be designed following concise guidelines that focus on data rendering from the Claude Code output.

Color-Coded Context Bars

The context bar of oh-my-claude exhibits prudent design: its color changes based on how full it is, ensuring users are kept aware of their resource usage effectively.

Example of Context Progress:

  ██████░░░░░░░░░ 30%     ← green, you're fine
! █████████░░░░░░ 60%     ← yellow, heads up
- ████████████░░░ 80%     ← red, time to /compact

Conclusion

oh-my-claude serves not only to beautify the coding experience but also to enhance productivity by providing timely feedback about development sessions. With a remarkable selection of plugins and themes, it empowers users to customize their statusline, all while ensuring a seamless coding environment.