Usage & Keybinds
Navigation
Up/Down: Select projectEnter: Browse entries (dashboard) / Select workspace (workspace picker)Right/Tab: Switch to entries (dashboard)Left/Shift+Tab: Switch to projects (dashboard)Esc: Back to projects (from entries) / Close modalq: Quit
Entries (Dashboard)
Up/Down: Select entry (when browsing entries)b: Copy selected entry titlen: Copy selected entry hours
Dates
t: Todayy: Yesterdayd: Open date range modalk: Toggle vacation day for active dayj: Toggle sick day for active day[/]: Shift current active date range backward/forwardTab: Switch between start/end in date range modal
Rollups
o: Open rollups vieww: Weekly rollupsm: Monthly rollupsy: Yearly rollups[/]: Previous/next rollup yearTab: Switch focus between periods and daysUp/Down: Navigate periods or daysLeft/Right: Move one step in period/day listsk: Toggle vacation day for selected dayj: Toggle sick day for selected dayShift+R: Refetch selected day/week/month/year from Toggl APIEsc: Back to dashboard
Rollups data coverage:
- Period rows show
!Nd n/fwhenNincluded days are not fetched. - Calendar shows
n/fand?markers for days not fetched yet. - The rollup summary shows a single signed
Overtimebalance for the selected period. - Sick/vacation days can use full-day targets while crediting fewer worked hours.
Clipboard
c: Copy all entries for the selected clientv: Copy entries for the selected projectx: Copy entries with client + project + entry and total hours
Clipboard format:
• Client — Project — Entry (2.50h)
Total hours: 8.00h
Refresh & Cache
r: Manual refresh (API call if quota allows)
Help & Settings
h: Help modals: Settings modalg: Open Theme Studio in the browserm: Cycle bundled and saved custom themes
Settings → General includes:
- Theme for cycling theme selection in-app
- Theme Studio for the browser-based custom theme editor
- optional time rounding (increment + mode)
Theme Studio opens at http://timeshit.studio.localhost:<random-port>/ using a random free loopback port. It never binds to LAN interfaces.
CLI
timeshit: Launch the TUItimeshit --theme-studio: Open Theme Studio directly without entering the TUI first
Status & Toasts
Short status messages appear in the footer and auto-hide after a few seconds. Copy actions also show a small toast in the dashboard.