# Send Toggl CLI – Time tracking for you and your agent to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "toggl-cli", "name": "Toggl CLI – Time tracking for you and your agent", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/FroeMic/toggl-cli", "canonicalUrl": "https://clawhub.ai/FroeMic/toggl-cli", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/toggl-cli", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=toggl-cli", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "toggl-cli", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-01T13:08:54.010Z", "expiresAt": "2026-05-08T13:08:54.010Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=toggl-cli", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=toggl-cli", "contentDisposition": "attachment; filename=\"toggl-cli-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "toggl-cli" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/toggl-cli" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/toggl-cli", "downloadUrl": "https://openagent3.xyz/downloads/toggl-cli", "agentUrl": "https://openagent3.xyz/skills/toggl-cli/agent", "manifestUrl": "https://openagent3.xyz/skills/toggl-cli/agent.json", "briefUrl": "https://openagent3.xyz/skills/toggl-cli/agent.md" } } ``` ## Documentation ### toggl-cli Interact with your Toggl Track workspace via the toggl-cli. ### Install Clone and install the CLI: git clone https://github.com/FroeMic/toggl-cli cd toggl-cli npm install npm run build npm link Set TOGGL_API_TOKEN environment variable (get it from Toggl Profile Settings): Recommended: Add to ~/.claude/.env for Claude Code Alternative: Add to ~/.bashrc or ~/.zshrc: export TOGGL_API_TOKEN="your-api-token" Optionally set default workspace: export TOGGL_WORKSPACE_ID="your-workspace-id" Repository: https://github.com/FroeMic/toggl-cli ### Time Entries (alias: te) toggl te start --description "Working on feature" # Start a timer toggl te stop # Stop the running timer toggl te current # Get current running entry toggl te list # List recent entries toggl te list --start-date 2024-01-01 # List from date to now toggl te list --start-date 2024-01-01 --end-date 2024-01-31 # Date range toggl te get # Get entry by ID toggl te create --start "2024-01-15T09:00:00Z" --duration 3600 --description "Meeting" toggl te update --description "Updated" # Update entry toggl te delete # Delete entry ### Projects (alias: proj) toggl proj list # List all projects toggl proj list --active true # List active projects only toggl proj get # Get project details toggl proj create --name "New Project" --color "#FF5733" toggl proj update --name "Renamed" toggl proj delete ### Clients toggl client list # List clients toggl client list --status archived # List archived clients toggl client create --name "Acme Corp" --notes "Important client" toggl client archive # Archive a client toggl client restore # Restore archived client toggl client delete ### Tags toggl tag list # List tags toggl tag create --name "urgent" toggl tag update --name "high-priority" toggl tag delete ### Tasks toggl task list --project toggl task create --name "Implement feature" --project toggl task update --project --name "Updated task" toggl task delete --project ### Workspaces (alias: ws) toggl ws list # List workspaces toggl ws get # Get workspace details toggl ws users list --workspace # List workspace users ### Organizations (alias: org) toggl org get # Get organization details toggl org users list --organization # List org users ### Groups toggl group list --organization toggl group create --organization --name "Development Team" toggl group update --organization --name "Engineering Team" toggl group delete --organization ### User Profile toggl me get # Get your profile toggl me get --with-related-data # Include workspaces, etc. toggl me preferences # Get user preferences toggl me quota # Get API rate limit info ### Output Formats All list/get commands support --format option: toggl te list --format json # JSON output (default) toggl te list --format table # Human-readable table toggl te list --format csv # CSV for spreadsheets ### Key Concepts ConceptPurposeExampleTime EntriesTrack time spent on tasks"2 hours on Project X"ProjectsGroup related time entries"Website Redesign"ClientsGroup projects by customer"Acme Corp"WorkspacesSeparate environments"Personal", "Work"TagsCategorize entries"billable", "meeting"TasksSub-items within projects"Design mockups" ### API Reference Base URL: https://api.track.toggl.com/api/v9 Auth: HTTP Basic with API token as both username and password Rate Limits: 1 request/second (leaky bucket), 30-600 requests/hour (quota) ### Common API Operations Get current user: curl -u $TOGGL_API_TOKEN:api_token https://api.track.toggl.com/api/v9/me List time entries: curl -u $TOGGL_API_TOKEN:api_token \\ "https://api.track.toggl.com/api/v9/me/time_entries?start_date=2024-01-01&end_date=2024-01-31" Start a timer: curl -X POST -u $TOGGL_API_TOKEN:api_token \\ -H "Content-Type: application/json" \\ -d '{"workspace_id": 123, "start": "2024-01-15T09:00:00Z", "duration": -1, "created_with": "curl"}' \\ https://api.track.toggl.com/api/v9/workspaces/123/time_entries Stop a timer: curl -X PATCH -u $TOGGL_API_TOKEN:api_token \\ https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/time_entries/{entry_id}/stop ### Notes The CLI handles rate limiting automatically with retry and exponential backoff. Negative duration on a time entry indicates a running timer. When using --start-date alone, --end-date defaults to now. Using --end-date without --start-date will error (API requires both). All timestamps are in ISO 8601 format. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: FroeMic - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-01T13:08:54.010Z - Expires at: 2026-05-08T13:08:54.010Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/toggl-cli) - [Send to Agent page](https://openagent3.xyz/skills/toggl-cli/agent) - [JSON manifest](https://openagent3.xyz/skills/toggl-cli/agent.json) - [Markdown brief](https://openagent3.xyz/skills/toggl-cli/agent.md) - [Download page](https://openagent3.xyz/downloads/toggl-cli)