toggl-cli

Toggl CLI

Configuration

.toggl-cli file in the home directory. The file should contain the following:

toggl:
  token: <your_api_token>
  workspace_id: <your_workspace_id>

The configuration can be generated using the toggl-cli config command. The token can be obtained from the Toggl website.

7pace Timetracker (optional)

To post worklogs to an on-prem 7pace Timetracker instance, add a sevenpace section to the config (also prompted for by toggl-cli config):

sevenpace:
  base_url: https://timetracker.example.com:8090/api/YourCollection/rest
  domain: CORP
  username: <windows_username>
  password: <windows_password>
  activity_type_id: <optional_activity_type_uuid>
  insecure_skip_verify: false # set true only for self-signed corp certs

The on-prem 7pace REST API uses NTLM (Windows) authentication, so the domain username and password are stored in the config file in plaintext. Reaching the instance also requires being on the corporate network / VPN.

Commands

• toggl-cli workspaces - List all workspaces
• toggl-cli start - Start a new time entry
• toggl-cli current - Show the current time entry
• toggl-cli continue - Continue the last time entry
• toggl-cli stop - Stop the current time entry
• toggl-cli edit - Edit a recent/running entry's description, project or start time
• toggl-cli history - List time entries
• toggl-cli projects - List projects
• toggl-cli www - Open the Toggl website
• toggl-cli config - Generate config for the CLI tool
• toggl-cli 7pace sync - Post Toggl entries for a date range to 7pace as worklogs
• toggl-cli 7pace add - Post a single worklog to 7pace

Editing entries

toggl-cli edit updates a recent or running entry (select an older one with --index/-i, 0 = most recent). Change the description (--description/-d), project (--project/-p) or start time (--start/-s).

The start time is interpreted in your configured timezone (toggl.timezone). It accepts "YYYY-MM-DD HH:MM", HH:MM (keeps the entry's date) or YYYY-MM-DD. For a stopped entry the end time stays fixed and the duration is recomputed:

toggl-cli edit --start 09:00                    # fix today's running/last entry
toggl-cli edit -i 1 --start "2024-06-01 08:30"  # older entry, full date+time

7pace worklogs

toggl-cli 7pace sync fetches your Toggl entries and posts each one to 7pace. The Azure DevOps work item id is parsed from the entry description (e.g. #1234 fix bug, AB#1234 ..., or a leading 1234 - ...); entries without a work item id are skipped and reported. It accepts the same date flags as history (--week, --month, --start, --end).

There is no de-duplication — re-running the same range creates duplicate worklogs. Always preview first with --dry-run:

toggl-cli 7pace sync --week --dry-run   # preview
toggl-cli 7pace sync --week             # post (asks for confirmation)

toggl-cli 7pace add posts a one-off worklog:

toggl-cli 7pace add --work-item 1234 --duration 1h30m --comment "code review"