Bringing Heyweek to your terminal
Track time without leaving your terminal. Perfect for anyone who prefers the command line.
# Install with Homebrew (macOS & Linux) $ brew tap heyweek/heyweek-cli $ brew install heyweek-cli # Or with Scoop on Windows $ scoop bucket add heyweek https://github.com/heyweek/homebrew-heyweek-cli.git $ scoop install heyweek # Or the universal install script $ curl -fsSL https://s3.eu-central-1.amazonaws.com/heyweek.staging.cli/install.sh | bash # Check it works $ hw version
Built for Terminal Workflows
Integrate time tracking seamlessly into your command-line workflow
Native Terminal Experience
Fast, lightweight CLI that feels right at home in your terminal.
Smart Time Tracking
Start, stop, and manage timers with simple commands. No context switching.
Project Management
Create, list, and switch between projects directly from your terminal.
Client Management
Manage client information and associate time entries with specific clients.
Work Logs
View, create, and manage detailed work logs with descriptions and tags.
Secure & Private
Token-based authentication with encrypted data transmission.
Quick Installation
Get started in seconds with your preferred package manager
Homebrew (recommended) Recommended
$ brew tap heyweek/heyweek-cli $ brew install heyweek-cli
Manual download Alternative
Prefer a binary? Grab the latest release from GitHub. View releases
Verify Installation
$ hw version
Authentication
# Comment1 $ hw auth login # Comment2 $ hw auth renew # Comment3 $ hw auth logout
Time Tracking
# Comment1 $ hw timer start -d "Example" # Comment2 $ hw timer status # Comment3 $ hw timer stop
Project Management
# Comment1 $ hw project list # Comment2 $ hw project create --name "Example" # Comment3 $ hw project delete <project-id>
Work Logs
# Comment1 $ hw log list --limit 10 # Comment2 $ hw log create --description "Example" # Comment3 $ hw log delete <log-id>
Command-line time tracking for developers
The Heyweek CLI is command-line time tracking built for people who live in the terminal. Start timers, log work, manage projects and clients, and script your workflow without ever reaching for the mouse — all syncing with the same Heyweek workspace as the web and mobile apps.
For developers and power users, the fastest interface is the keyboard. The Heyweek CLI lets you track time, switch projects, and log work with a few keystrokes, then automate the repetitive parts with scripts in shell, Node.js, or Python. Time tracking stops being a chore you remember to do and becomes part of your existing terminal workflow.
Because the CLI talks to the same workspace as everything else, the hours you track from the command line become billable time, project progress, and reportable data automatically. Install it via your usual package manager, wire it into your scripts and CI, and keep tracking without breaking flow.
Frequently asked questions
What can I do with the Heyweek CLI?
Start and stop timers, log work, and manage projects and clients straight from the terminal, with everything syncing to your Heyweek workspace.
Can I automate time tracking with scripts?
Yes. The CLI is scriptable in shell, Node.js, and Python, so you can automate repetitive tracking and wire it into your existing workflows.
How do I install the CLI?
It installs through common package managers across macOS, Windows, and Linux, so you can add it to your environment in seconds.
Does CLI-tracked time appear in invoices and reports?
It does — time tracked from the command line flows into the same projects, invoices, and reports as the rest of Heyweek.