New community plugin: utt-balance - Daily/weekly time balance tracking

[loganthomas]

Hi @larose 👋

Thank you again for building such an awesome project!

I've been using utt for a while and built a plugin I'd love to share with the community: utt-balance (also on PyPI).

What it does

utt-balance adds a balance command that shows your worked time against daily and weekly targets:

┌──────────────┬─────────┬───────────┐
│              │  Worked │ Remaining │
├──────────────┼─────────┼───────────┤
│ Today        │   5h30  │     2h30  │
│ Since Sunday │  28h00  │    12h00  │
└──────────────┴─────────┴───────────┘

Features:

• 📊 Daily & weekly tracking at a glance
• 🎨 Color-coded output (green = under target, yellow = at target, red = over)
• ⚙️ Configurable targets (--daily-hrs, --weekly-hrs, --week-start)
• 🔌 Native plugin API integration (no subprocess calls)

Why I built it

I wanted a quick visual check to support work-life balance—a reminder to stay within my pre-allocated work time. The color coding makes it easy to see at a glance whether I'm on track.

Request

1. Review: Would you mind taking a look to ensure it aligns with your expectations for plugins? I have it as a release candidate (0.1.0-rc.2) while awaiting feedback.

2. Plugin listing: Once approved, I'd appreciate a link in the repo's plugin documentation.

3. Best practices: Please let me know if there's anything I should update to follow best practices.

What's next

I'm also still working on converting #115 into a plugin—will move onto that once this is settled.

Thanks again for your time!

[larose]

Thanks @loganthomas! I added it to the readme. I looked briefly at the code, and it seems to be using the API as expected, so it looks good on this side.