Timeshit NxTSolutions

Timeshit (Toggl2Timeshit)

Timeshit is a Rust-based Terminal UI (TUI) that turns Toggl Track time entries into a clean, navigable timesheet dashboard. It is optimized for free-tier API limits with a persistent cache and manual refresh.

Highlights

• Modern TUI dashboard with grouped summaries and entry details
• Workspace selection and fast date range filtering
• Clipboard export for timesheet tools
• Cache-first design to reduce Toggl API usage
• Built-in settings (target hours, integrations, theme)

Screenshots

Installation

macOS

Homebrew (recommended)

brew tap NoahNxT/nxt-solutions-packages
brew install timeshit

Upgrade:

brew upgrade timeshit

If you previously installed the legacy Node package, you may need to unlink it:

rm /opt/homebrew/bin/timeshit
brew link --overwrite timeshit

You can also remove the legacy global npm package:

npm remove -g toggl2timeshit

Windows

Chocolatey

choco install timeshit

choco install timeshit --version=1.8.1

Scoop

scoop bucket add nxt-solutions https://github.com/NoahNxT/scoop-nxt-solutions-packages
scoop install timeshit

Winget

winget install NxTSolutions.Timeshit

Linux

APT (Debian/Ubuntu via Cloudsmith)

curl -1sLf 'https://dl.cloudsmith.io/public/nxt-solutions/timeshit/setup.deb.sh' | sudo -E bash
sudo apt-get update
sudo apt-get install timeshit

If timeshit is not found after setup, verify the package is installed:

dpkg -s timeshit
which timeshit

If timeshit is installed but not in PATH, run it directly:

/usr/bin/timeshit
hash -r

If apt can’t find the package, force the distro/codename that matches your Cloudsmith publish target:

curl -1sLf 'https://dl.cloudsmith.io/public/nxt-solutions/timeshit/setup.deb.sh' \
  | sudo -E distro=ubuntu codename=noble bash

GitHub Releases (any OS)

Download the latest asset from GitHub Releases and place it in your PATH.

Release assets:

• Linux: timeshit-linux.tar.gz
• macOS: timeshit-macos.tar.gz
• macOS PKG: timeshit-macos.pkg
• Windows: timeshit-windows.zip

Build from Source

cargo build --release

Binary: target/release/timeshit

Updates

• GitHub Releases installs use the in-app updater.
• Package manager installs should be updated via the package manager (brew/apt/choco/scoop/winget).

Authentication

Use the in-app settings (Settings → Integrations) or set an environment variable:

export TOGGL_API_TOKEN="your-token"

Token file: ~/.toggl2tsc

Usage

timeshit

Date range selection is done inside the TUI (d).

Keybinds (core)

• h help
• c copy client entries
• v copy project entries
• x copy entries with client + project
• d set date range
• k toggle vacation/non-working for active day
• y yesterday
• [ / ] previous / next active date range
• r refresh
• Arrow keys to navigate projects

Keybinds (rollups)

• o open rollups
• w weekly view
• m monthly view
• y yearly view
• Shift+R refetch selected day/week/month/year
• z toggle weekends in rollups
• k toggle vacation/non-working for selected day

Docs

Full documentation lives in docs/ and is published via GitHub Pages.

Project

• Changelog: CHANGELOG.md
• Contributing: CONTRIBUTING.md
• Security: SECURITY.md

License

MIT Direct download (PKG) Download timeshit-macos.pkg from GitHub Releases and run the installer.