Skip to content

Latest commit

ย 

History

History
40 lines (29 loc) ยท 3.69 KB

File metadata and controls

40 lines (29 loc) ยท 3.69 KB

Yield app icon Yield

Know what you've sown and what's left to reap. Yield sits in your macOS menu bar and shows how your logged hours in Harvest stack up against your booked hours in Forecast โ€” so you always know where your week stands.

โฌ‡๏ธ Download

Download the latest version

Unzip, drag Yield to your Applications folder, and launch. It'll take root in your menu bar. Sign in with your Harvest account and you're ready to go.

Requires macOS 14 (Sonoma) or later and a Harvest account with Forecast enabled.

โœจ Features

  • ๐Ÿ“Š At-a-glance weekly overview โ€” every project with color-coded progress bars showing logged vs. booked hours. Green when under budget, red when over.
  • ๐ŸŽ›๏ธ Configurable menu bar display โ€” pick what shows next to the icon: tracked vs. booked for the running project, current timer vs. today's total, or just the running timer. The icon itself rotates as a gauge tied to your progress on the active project.
  • ๐Ÿ“ˆ Weekly time chart โ€” stacked area chart showing hours by project across the week. Click a legend row to isolate a single project, or export the chart as a PNG.
  • ๐Ÿ“ Day-by-day breakdown โ€” expand any project to see a segmented bar of its daily contribution to the week, alongside its individual time entries.
  • ๐Ÿ” Day-of-week filter โ€” click a weekday in the header to narrow the list to projects you spent time on (or are booked on) that day.
  • ๐Ÿ”ญ Look-ahead โ€” see what's still ahead this week: expected hours per day, company holidays, your scheduled time off, and prospective Forecast bookings that aren't tied to a Harvest project yet.
  • ๐ŸŒด Time off awareness โ€” your Forecast PTO surfaces as a dedicated summary row, and the menu bar icon switches to a moon when you're off for the full day.
  • โ—€ โ–ถ Week navigation โ€” step backward through past weeks (read-only, with full drawers and the day-by-day bar) or forward to see what's booked next, with a "This Week" pill to jump back.
  • โฑ๏ธ Live timer controls โ€” start, stop, pause, and resume Harvest timers without leaving the menu bar. A duplicate-timer guard offers to resume an existing entry on the same project instead of doubling up.
  • โœ๏ธ Create & edit time entries โ€” log time with project and task dropdowns grouped by client. Edit (or double-click to edit) and delete entries inline. Start a timer with pre-filled hours for catch-up tracking.
  • ๐Ÿ“… Log time to any day โ€” add entries to any day in the current week, not just today.
  • ๐Ÿ“ Forecast notes โ€” assignment notes from Forecast surface on project rows; hover the icon to read the full text.
  • ๐Ÿ’ค Idle detection โ€” alerts you when you've been idle, with options to continue, stop, or keep the time.
  • ๐Ÿ”” Budget notifications โ€” nudges you when you hit your booked target on a project so you know when to move on.
  • ๐Ÿ”„ Auto-refresh โ€” lightweight refresh every minute picks up timer changes; full refresh on menu open and at day or week rollover keeps Forecast data current. Active timers tick locally so numbers always feel real-time.
  • ๐Ÿš€ Automatic updates โ€” checks for new versions daily and prompts you to install them.

๐Ÿšœ Getting started

  1. Launch Yield โ€” look for the gauge icon in your menu bar
  2. Sign in with Harvest โ€” click the icon and hit "Sign in with Harvest." This connects your Forecast data automatically.
  3. That's it. Your week's projects, hours, and timers are all right there.

For development info, see CONTRIBUTING.md.

โšก