Usage & Keybinds

Navigation

• Up/Down: Select project
• Enter: 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 modal
• q: Quit

Entries (Dashboard)

• Up/Down: Select entry (when browsing entries)
• b: Copy selected entry title
• n: Copy selected entry hours

Dates

• t: Today
• y: Yesterday
• d: Open date range modal
• k: Toggle vacation day for active day
• j: Toggle sick day for active day
• [ / ]: Shift current active date range backward/forward
• Tab: Switch between start/end in date range modal

Rollups

• o: Open rollups view
• w: Weekly rollups
• m: Monthly rollups
• y: Yearly rollups
• [ / ]: Previous/next rollup year
• Tab: Switch focus between periods and days
• Up/Down: Navigate periods or days
• Left/Right: Move one step in period/day lists
• k: Toggle vacation day for selected day
• j: Toggle sick day for selected day
• Shift+R: Refetch selected day/week/month/year from Toggl API
• Esc: Back to dashboard

Rollups data coverage:

• Period rows show !Nd n/f when N included days are not fetched.
• Calendar shows n/f and ? markers for days not fetched yet.
• The rollup summary shows a single signed Overtime balance 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 client
• v: Copy entries for the selected project
• x: 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 modal
• s: Settings modal
• g: Open Theme Studio in the browser
• m: 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 TUI
• timeshit --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.