English | 中文

toggl-cli

Unofficial CLI for Toggl Track and OpenToggl, written in Rust.

toggl-cli works with both the official Toggl service and self-hosted OpenToggl instances, so you can keep the same CLI workflow either way.

Install

npm install -g @correctroadh/toggl-cli

// to verify
toggl --help

Agent one-click install (skill)

Claude Code/OpenClaw

npx skills add CorrectRoadH/toggl-cli

Quick Start

Use OpenToggl if Toggl rate limits are getting in the way or you need self-hosting. OpenToggl is a fully-compatible alternative you can deploy yourself.

Use with Toggl Track

toggl auth <YOUR_API_TOKEN>

Use with OpenToggl

toggl auth <YOUR_API_TOKEN> --api-type opentoggl --api-url https://your-instance.com/api/v9

You can also run interactive auth:

toggl auth

The API token is stored securely in your Operating System's keychain using the keyring crate.

On some Linux environments the keyring store may not persist across reboots. In that case, set TOGGL_API_TOKEN in your shell profile instead.

Why toggl-cli

• Works with both official Toggl Track and self-hosted OpenToggl
• Simple CLI for daily time tracking, project, task, and tag workflows
• Local HTTP caching reduces repeated API calls on read-heavy commands
• Interactive auth and command flows when you do not want to pass everything as flags

Common Commands

# Start and stop time tracking
toggl entry start -d "Write code" -p MyProject -t dev cli
toggl entry stop
toggl entry current

# List entries
toggl entry list -n 10
toggl entry list --since 2026-03-06 --until 2026-03-06
toggl entry list --since "2026-03-06 09:00" --until "2026-03-06 18:30"

# Workspace resources
toggl project create "New Project"
toggl task create --project MyProject "Code Review"
toggl tag create "deep-work"

# Reports
toggl report summary --since 2026-03-01 --until 2026-03-31
toggl report detailed --since 2026-03-01 --until 2026-03-31
toggl report weekly --since 2026-03-17 --until 2026-03-23

For toggl entry list, date-only values are interpreted in local time. --since YYYY-MM-DD means the start of that day, and --until YYYY-MM-DD includes the full day.

Run toggl --help to see all commands.

Maintained by CorrectRoadH | Upstream: watercooler-labs/toggl-cli