tide

A terminal interface for tracking "third time."

How it works

Tide keeps track of two times:

• Total time worked
• Break time remaining

Break time is earned at a 1:3 ratio of work time. For example, if you work for 30 minutes, you earn 10 minutes of break time.

Modes

The timer supports three modes:

• Working: Counts work time and adds break time at the 1:3 ratio
• Break: Subtracts from earned break time
• Untracked: Timer is inactive

How to use

1. Run the command: tide
2. Switch between modes as needed
3. Your time is automatically saved and persists between sessions

Persistence

Time state is stored in a JSON file at $XDG_STATE_HOME/tide/. When the program starts, it loads the previous state if it exists.

Tech stack

• Go
• Bubbletea (TUI framework)
• Lipgloss (TUI styling)

Developing

1. Clone the repository
2. Run go run . to start the program