Skip to content

KeepGoing Hub 0.1.0

Choose a tag to compare

@mrth2 mrth2 released this 16 Oct 06:10
· 2 commits to main since this release

Superseded by KeepGoing Den 0.3.0. This build gets no further fixes. 0.2.x updates itself; on 0.1.0, download the latest DMG.

The first release. It is not yet checked on every Mac, and there is no updater: a newer version
is installed by downloading the DMG again.

Room

  • A pixel-art room you open from the menu bar, whose sky turns with the hour, dimming and showing stars at night.
  • A wall clock in the style of a Time Timer: a running Focus Session or Break is a coloured wedge to its end minute. Click it to start a Session; while one runs, it asks before stopping.
  • A swing-arm desk lamp whose light reaches further the more of a Time Budget is used, overheating once over it.
  • A shelf of books for your six most recent Projects, your character in the Room, and a door to the Commitropolis companion.

Pet

  • A Pet in a corner of the screen that floats over your work and never takes focus. Drag it to another corner and it runs there along the edge and stays.
  • It adopts your Momentum Mascot character and corner, offers to quit the Mascot and take it out of your login items, or lets you build a character from layers.
  • Its mood follows your momentum (awake, dozing, asleep, comeback) and it reacts to a Session, a Drift or a Break; during a Break it carries a small timer disc.
  • A signboard banner beside the Pet says once, outside any Session, when a Project goes over its Time Budget.

Menu bar

  • A KG mark with a menu to start or stop a Session and open the Room, All projects, the Timeline, the Day record and Settings. The running Focus time is shown only here.

Focus sessions

  • Sessions loop like Pomodoro, four to a run by default, and the Start panel sets the focus minutes and session count for one run.
  • A Session pauses while the Mac sleeps, is locked or shows the screen saver, and one left open by a crash is offered back at launch.
  • Leaving a Project's desktop for longer than the dwell counts as a Drift, with one quiet Nudge on the Pet. Nudges are held back while a macOS Focus is on.
  • Seven soft sound cues for Session, Break, Drift and Degraded moments, off by default.

Projects and time

  • Create a Project from a folder, bind desktops to it by picking from a list, and mark chat or music displays as ambient so Drift ignores them.
  • Time on a bound desktop or from file changes in a Project's folder is counted while no Session runs, and idle time is not.
  • Set working days and a daily or weekly Time Budget as an at least and at most range; an impossible range is refused with both numbers named.
  • The Project panel lists each day's time as unbroken runs, with where each was and why it ended.
  • Name any desktop from Settings or from a Project, and the Hub says that name everywhere.
  • If desktop detection stops working, the Hub says so, stops counting desktop time and keeps everything else running.

Day Record

  • A planter along the front of the Room that grows a plant for each stretch of work: bigger past 15 and 45 minutes, and in bloom at 90. Past days stay readable from the Day record.

Timeline

  • A report over a day, a week or a month, as a chart or a list, with uncertain time in its own lane until you count it.
  • Move or discard any stretch of time, undo the correction, and export the range as a tab-separated file.

Claude Code

  • An opt-in statusline for Claude Code, offered only where Claude Code is installed, showing model, context left, session time, files touched and commits. Set it up in Settings once the Hub runs from Applications. Opting out restores your old setting exactly.
  • Claude Code session activity in a Project's folder counts toward that Project, through a local drop folder that sets aside anything malformed.

Setup and settings

  • First-run onboarding that binds your first Project to a desktop and sets up your character, and Settings that take effect at once, including Large Text on every surface.