@devclocked/cli
v2.8.3
Published
DevClocked CLI - Terminal time tracking for developers
Maintainers
Readme
DevClocked CLI
Terminal time tracking for developers. Track your terminal activity without logging commands.
Installation
npm install -g @devclocked/cliRunning Codex or Claude Code on an SSH server? Follow the remote hosting guide, including the complete Hetzner example.
Usage
Login
Authenticate with your DevClocked API key:
devclocked loginGet your API key from: https://app.devclocked.com/settings
Start Tracking
Start a tracked terminal session:
devclocked sessionThis spawns a wrapped shell that tracks activity timing. Type exit to end the session.
Check Status
View your current tracking status:
devclocked statusFlush Queue
Force-send any pending ticks:
devclocked flushSync agent runs
Sync completed Claude Code and Codex runs from their local transcript stores:
devclocked agent-runs sync
devclocked agent-runs sync --dry-run
devclocked agent-runs sync --runtime codex --file /absolute/path/to/rollout.jsonl--file requires --runtime and an absolute path. The CLI resolves symlinks
and refuses files outside the selected runtime store. --dry-run parses and
prints aggregate counts without authenticating or uploading.
Logout
Clear your credentials:
devclocked logoutPrivacy Guarantees
- Commands are NOT logged
- Arguments are NOT logged
- Output is NOT stored
- Environment variables are NOT captured
- Only tracked: timestamps, working directory, git repo context
Agent-run sync reads transcript files locally and opens them read-only. It
uploads run timing, status, tool counts, token counts, models, and hashed
identifiers. It does not upload transcript paths, prompts, responses, command
text, or file contents. The CLI and daemon share a user-only salt at
~/.config/devclocked/agent-run-salt, so occurrence keys stay consistent
without either process rewriting the other's queue or cursor state.
Authentication remains in ~/.config/devclocked/cli.json.
Development
# From monorepo root
npm run cli:build
# Link for local testing
cd packages/cli
npm link
# Now you can use `devclocked` command
devclocked --help