timetracker-cli 1.0.7

timetracker-cli

A .NET 10 command-line tool for logging and managing time entries in 7pace Timetracker.

Installation

Requires .NET 10 SDK or Runtime.

dotnet tool install -g timetracker-cli

Update

dotnet tool update -g timetracker-cli

Uninstall

dotnet tool uninstall -g timetracker-cli

Prerequisites

• .NET 10 SDK
• A 7pace Timetracker instance with a valid Bearer Token

Build from source

dotnet build Timetracker.Console
dotnet publish Timetracker.Console -c Release

First-time setup

Before using any command, run config to authenticate and cache your activity types locally:

timetracker config -u https://<company>.timehub.7pace.com -t <bearer-token>

Commands

• config
• activities
• add
• list
• interactive
• update
• copy
• delete
• import

config

Configure the connection to your Timetracker instance.

*Required when setting up or updating credentials.

# Initial setup
timetracker config -u https://acme.timehub.7pace.com -t eyJ...

# View current config
timetracker config --show

# Remove all local config
timetracker config --reset

activities

List available activity types. Uses a local cache populated during config.

# List cached activity types
timetracker activities

# Sync from server then list
timetracker activities --sync

add

Create a new time entry.

# Log 2 hours of development on today
timetracker add -d today -w 12345 -l 2 -t Development -c "Feature X"

# Log half an hour of a meeting starting at 14:00
timetracker add -d 2026/06/19 -w 12345 -l 0.5 -t Meeting -h 14:00

# Preview before submitting
timetracker add -d today -w 12345 -l 1 -t Development --dry-run

list

List time entries for a period.

All period shortcuts (--today, --yesterday, --week, --last-week, --month, --last-month) and --period are mutually exclusive and cannot be combined with --from or --to.

# Today's entries
timetracker list --today

# Yesterday's entries
timetracker list --yesterday

# Current week
timetracker list --week

# Previous week
timetracker list --last-week

# Current month
timetracker list --month

# Previous month
timetracker list --last-month

# Specific date range
timetracker list -f 2026/06/01 -t 2026/06/30

# Specific month summary by day
timetracker list --period 2026/06 --summary

# Filter by work item and show IDs (for delete/update)
timetracker list --week --work-item 12345 --ids

# Export week as JSON for batch upload
timetracker list --week --output json > worklogs.json

# Export month as CSV
timetracker list --month --output csv > worklogs.csv

interactive

Browse, create, copy, edit and delete time entries in an interactive terminal UI. Navigate with arrow keys and confirm actions via prompts. Defaults to today's entries.

# Browse today's entries
timetracker interactive

# Browse this week's entries
timetracker interactive --week

# Browse a specific month
timetracker interactive --period 2026/06

# Browse filtered by work item
timetracker interactive --week --work-item 12345

Flow:

• Select an entry → choose Edit, Copy, Delete, or Back → confirm/fill fields → returns to the list automatically.
• Edit → update any field; activity type change is optional (confirm prompt).
• Copy → pre-fills all fields from the original entry (date defaults to today); edit any field before saving as a new entry.
• Delete → confirmation prompt before removal.
• Select ── New entry ── → fill in date, start hour, work item, duration, activity type, and comment → entry is created and the list refreshes.
• Select ── Exit ── to quit.

update

Update one or more fields of an existing time entry. Only the fields provided are changed.

# Fix the duration of an entry
timetracker update -i <id> -l 3

# Change the work item and comment
timetracker update -i <id> -w 99999 -c "Moved to correct item"

copy

Duplicate an existing entry to a target date (defaults to today). Preserves work item, duration, activity type, comment, and start time.

# Copy a recurring entry to today
timetracker copy -i <id>

# Copy to a specific date
timetracker copy -i <id> -d 2026/06/20

delete

Delete one or more time entries by ID.

# Delete a single entry (with confirmation)
timetracker delete -i <id>

# Delete multiple entries
timetracker delete -i <id1> -i <id2> -i <id3>

# Delete multiple entries using comma separator
timetracker delete -i <id1>,<id2>,<id3>

# Skip confirmation
timetracker delete -i <id1> -i <id2> --force

import

Import multiple time entries from a JSON file. The file must be an array of worklog objects, compatible with the output of list --output json.

# Preview what would be imported
timetracker import --file worklogs.json --dry-run

# Import
timetracker import --file worklogs.json

Common workflows

Manage entries interactively

For day-to-day work, interactive is the fastest path — create, copy, edit, and delete without memorizing flags. It defaults to today's entries.

# Drive the whole day from a single terminal UI
timetracker interactive

# Review and fix a past week
timetracker interactive --last-week

Log a full day

# Several entries on the same day, across different work items
timetracker add -d today -w 12345 -l 2 -t Development -c "Feature X"
timetracker add -d today -w 12345 -l 1.5 -t Development -c "Code review"
timetracker add -d today -w 67890 -l 0.5 -t Meeting -h 14:00 -c "Daily"

# Review what was logged
timetracker list --today

Find and delete an entry

# List today's entries with IDs
timetracker list --today --ids

# Delete the target entry
timetracker delete -i <id>

Fix an entry logged to the wrong work item

timetracker list --today --ids
timetracker update -i <id> -w <correct-work-item>

Copy a recurring daily entry

# Find the original entry ID once
timetracker list -f 2026/06/01 -t 2026/06/01 --ids

# Copy it every day
timetracker copy -i <id>

Export, edit, and re-import a week

# Export
timetracker list --week --output json > worklogs.json

# Edit worklogs.json as needed, then preview
timetracker import --file worklogs.json --dry-run

# Import
timetracker import --file worklogs.json

Replicate last week

For a fixed weekly routine, export the previous week, shift the dates, and re-import.

# Export last week
timetracker list --last-week --output json > lastweek.json

# Edit lastweek.json: bump each "date" forward by 7 days, then preview
timetracker import --file lastweek.json --dry-run

# Import
timetracker import --file lastweek.json

Check for missing entries

Spot days with incomplete or no hours before the month closes.

# Daily totals for the current week — gaps stand out
timetracker list --week --summary

# Same for a specific month
timetracker list --period 2026/06 --summary

Monthly summary

# Current month
timetracker list --month --summary

# Specific month
timetracker list --period 2026/06 --summary

Security

Credential storage

The bearer token and user info are stored locally in a config file. The location and protection method depend on the OS:

On Windows, the encrypted token can only be decrypted by the same OS user account that ran config. On Linux/macOS, the file is not encrypted but is restricted to the owner.

HTTPS enforcement

The --url option only accepts https:// URLs. Plain HTTP is rejected to prevent the bearer token from being transmitted over an unencrypted connection.

Troubleshooting

401 Unauthorized on any command

The bearer token has expired or is invalid. Run config again with a new token:

timetracker config -u https://<company>.timehub.7pace.com -t <new-token>

Activity type 'X' not found

The local activity cache is out of sync with the server. Refresh it:

timetracker activities --sync

config.json does not exist

The tool has not been configured yet. Run the first-time setup:

timetracker config -u https://<company>.timehub.7pace.com -t <bearer-token>

The provided URL is invalid or does not use HTTPS

The URL must start with https://. Example:

# Wrong
timetracker config -u http://acme.timehub.7pace.com -t <token>

# Correct
timetracker config -u https://acme.timehub.7pace.com -t <token>