Clocktopus CLI

Command-line interface for Clocktopus time tracking.

Installation

npm install -g @blastin-dev/clocktopus-cli

Or run directly with npx:

npx @blastin-dev/clocktopus-cli <command>

Getting Started

Authenticate with your Clocktopus account:

clocktopus login

This will open a browser window where you authorize the CLI. Once complete, your session is stored locally.

Commands

clocktopus login

Authenticate using the device authorization flow. Opens a URL in your browser to approve access.

clocktopus logout

Clear stored credentials.

clocktopus whoami

Display the current authenticated user.

clocktopus clock (in|out)

clocktopus clock (in|out) [--ago <duration> | --at <time>]

Record the start or end of a work session. Defaults to "now" when no flag is passed.

| Option | Description | | --- | --- | | --ago <duration> | Backdate by a duration from now (15m, 1h, 1h30m). Mutually exclusive with --at. | | --at <time> | Backdate to an absolute wall-clock time today (HH:mm or HH:mm:ss). |

clocktopus clock status

clocktopus clock status [-d <YYYY-MM-DD>]

Show clock signals for a given date.

| Option | Description | | --- | --- | | -d, --date <date> | Show signals for a specific date in YYYY-MM-DD format. Defaults to today. |

Token Storage

Credentials are stored in a platform-specific config directory:

• macOS: ~/Library/Preferences/clocktopus-cli-nodejs/conf ig.json
• Linux: ~/.config/clocktopus-cli-nodejs/config.json
• Windows: %APPDATA%/clocktopus-cli-nodejs/config.json

Run clocktopus logout to clear stored credentials.