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

Record a clock-in signal.

clocktopus clock out

Record a clock-out signal.

clocktopus clock status

Show signals for a given date.

Token Storage

Credentials are stored in a platform-specific config directory:

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

Run clocktopus logout to clear stored credentials.