{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/toggl-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=toggl-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/toggl-cli",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "toggl-cli",
        "body": "Interact with your Toggl Track workspace via the toggl-cli."
      },
      {
        "title": "Install",
        "body": "Clone and install the CLI:\n\ngit clone https://github.com/FroeMic/toggl-cli\ncd toggl-cli\nnpm install\nnpm run build\nnpm link\n\nSet TOGGL_API_TOKEN environment variable (get it from Toggl Profile Settings):\n\nRecommended: Add to ~/.claude/.env for Claude Code\nAlternative: Add to ~/.bashrc or ~/.zshrc: export TOGGL_API_TOKEN=\"your-api-token\"\n\nOptionally set default workspace:\n\nexport TOGGL_WORKSPACE_ID=\"your-workspace-id\"\n\nRepository: https://github.com/FroeMic/toggl-cli"
      },
      {
        "title": "Time Entries (alias: te)",
        "body": "toggl te start --description \"Working on feature\"  # Start a timer\ntoggl te stop                                       # Stop the running timer\ntoggl te current                                    # Get current running entry\ntoggl te list                                       # List recent entries\ntoggl te list --start-date 2024-01-01              # List from date to now\ntoggl te list --start-date 2024-01-01 --end-date 2024-01-31  # Date range\ntoggl te get <id>                                   # Get entry by ID\ntoggl te create --start \"2024-01-15T09:00:00Z\" --duration 3600 --description \"Meeting\"\ntoggl te update <id> --description \"Updated\"        # Update entry\ntoggl te delete <id>                                # Delete entry"
      },
      {
        "title": "Projects (alias: proj)",
        "body": "toggl proj list                        # List all projects\ntoggl proj list --active true          # List active projects only\ntoggl proj get <id>                    # Get project details\ntoggl proj create --name \"New Project\" --color \"#FF5733\"\ntoggl proj update <id> --name \"Renamed\"\ntoggl proj delete <id>"
      },
      {
        "title": "Clients",
        "body": "toggl client list                      # List clients\ntoggl client list --status archived    # List archived clients\ntoggl client create --name \"Acme Corp\" --notes \"Important client\"\ntoggl client archive <id>              # Archive a client\ntoggl client restore <id>              # Restore archived client\ntoggl client delete <id>"
      },
      {
        "title": "Tags",
        "body": "toggl tag list                         # List tags\ntoggl tag create --name \"urgent\"\ntoggl tag update <id> --name \"high-priority\"\ntoggl tag delete <id>"
      },
      {
        "title": "Tasks",
        "body": "toggl task list --project <project_id>\ntoggl task create --name \"Implement feature\" --project <project_id>\ntoggl task update <id> --project <project_id> --name \"Updated task\"\ntoggl task delete <id> --project <project_id>"
      },
      {
        "title": "Workspaces (alias: ws)",
        "body": "toggl ws list                          # List workspaces\ntoggl ws get <id>                      # Get workspace details\ntoggl ws users list --workspace <id>   # List workspace users"
      },
      {
        "title": "Organizations (alias: org)",
        "body": "toggl org get <id>                     # Get organization details\ntoggl org users list --organization <id>  # List org users"
      },
      {
        "title": "Groups",
        "body": "toggl group list --organization <id>\ntoggl group create --organization <id> --name \"Development Team\"\ntoggl group update <id> --organization <org_id> --name \"Engineering Team\"\ntoggl group delete <id> --organization <org_id>"
      },
      {
        "title": "User Profile",
        "body": "toggl me get                           # Get your profile\ntoggl me get --with-related-data       # Include workspaces, etc.\ntoggl me preferences                   # Get user preferences\ntoggl me quota                         # Get API rate limit info"
      },
      {
        "title": "Output Formats",
        "body": "All list/get commands support --format option:\n\ntoggl te list --format json            # JSON output (default)\ntoggl te list --format table           # Human-readable table\ntoggl te list --format csv             # CSV for spreadsheets"
      },
      {
        "title": "Key Concepts",
        "body": "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\""
      },
      {
        "title": "API Reference",
        "body": "Base URL: https://api.track.toggl.com/api/v9\nAuth: HTTP Basic with API token as both username and password\nRate Limits: 1 request/second (leaky bucket), 30-600 requests/hour (quota)"
      },
      {
        "title": "Common API Operations",
        "body": "Get current user:\n\ncurl -u $TOGGL_API_TOKEN:api_token https://api.track.toggl.com/api/v9/me\n\nList time entries:\n\ncurl -u $TOGGL_API_TOKEN:api_token \\\n  \"https://api.track.toggl.com/api/v9/me/time_entries?start_date=2024-01-01&end_date=2024-01-31\"\n\nStart a timer:\n\ncurl -X POST -u $TOGGL_API_TOKEN:api_token \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"workspace_id\": 123, \"start\": \"2024-01-15T09:00:00Z\", \"duration\": -1, \"created_with\": \"curl\"}' \\\n  https://api.track.toggl.com/api/v9/workspaces/123/time_entries\n\nStop a timer:\n\ncurl -X PATCH -u $TOGGL_API_TOKEN:api_token \\\n  https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/time_entries/{entry_id}/stop"
      },
      {
        "title": "Notes",
        "body": "The CLI handles rate limiting automatically with retry and exponential backoff.\nNegative duration on a time entry indicates a running timer.\nWhen using --start-date alone, --end-date defaults to now.\nUsing --end-date without --start-date will error (API requires both).\nAll timestamps are in ISO 8601 format."
      }
    ],
    "body": "toggl-cli\n\nInteract with your Toggl Track workspace via the toggl-cli.\n\nInstall\n\nClone and install the CLI:\n\ngit clone https://github.com/FroeMic/toggl-cli\ncd toggl-cli\nnpm install\nnpm run build\nnpm link\n\n\nSet TOGGL_API_TOKEN environment variable (get it from Toggl Profile Settings):\n\nRecommended: Add to ~/.claude/.env for Claude Code\nAlternative: Add to ~/.bashrc or ~/.zshrc: export TOGGL_API_TOKEN=\"your-api-token\"\n\nOptionally set default workspace:\n\nexport TOGGL_WORKSPACE_ID=\"your-workspace-id\"\n\n\nRepository: https://github.com/FroeMic/toggl-cli\n\nCommands\nTime Entries (alias: te)\ntoggl te start --description \"Working on feature\"  # Start a timer\ntoggl te stop                                       # Stop the running timer\ntoggl te current                                    # Get current running entry\ntoggl te list                                       # List recent entries\ntoggl te list --start-date 2024-01-01              # List from date to now\ntoggl te list --start-date 2024-01-01 --end-date 2024-01-31  # Date range\ntoggl te get <id>                                   # Get entry by ID\ntoggl te create --start \"2024-01-15T09:00:00Z\" --duration 3600 --description \"Meeting\"\ntoggl te update <id> --description \"Updated\"        # Update entry\ntoggl te delete <id>                                # Delete entry\n\nProjects (alias: proj)\ntoggl proj list                        # List all projects\ntoggl proj list --active true          # List active projects only\ntoggl proj get <id>                    # Get project details\ntoggl proj create --name \"New Project\" --color \"#FF5733\"\ntoggl proj update <id> --name \"Renamed\"\ntoggl proj delete <id>\n\nClients\ntoggl client list                      # List clients\ntoggl client list --status archived    # List archived clients\ntoggl client create --name \"Acme Corp\" --notes \"Important client\"\ntoggl client archive <id>              # Archive a client\ntoggl client restore <id>              # Restore archived client\ntoggl client delete <id>\n\nTags\ntoggl tag list                         # List tags\ntoggl tag create --name \"urgent\"\ntoggl tag update <id> --name \"high-priority\"\ntoggl tag delete <id>\n\nTasks\ntoggl task list --project <project_id>\ntoggl task create --name \"Implement feature\" --project <project_id>\ntoggl task update <id> --project <project_id> --name \"Updated task\"\ntoggl task delete <id> --project <project_id>\n\nWorkspaces (alias: ws)\ntoggl ws list                          # List workspaces\ntoggl ws get <id>                      # Get workspace details\ntoggl ws users list --workspace <id>   # List workspace users\n\nOrganizations (alias: org)\ntoggl org get <id>                     # Get organization details\ntoggl org users list --organization <id>  # List org users\n\nGroups\ntoggl group list --organization <id>\ntoggl group create --organization <id> --name \"Development Team\"\ntoggl group update <id> --organization <org_id> --name \"Engineering Team\"\ntoggl group delete <id> --organization <org_id>\n\nUser Profile\ntoggl me get                           # Get your profile\ntoggl me get --with-related-data       # Include workspaces, etc.\ntoggl me preferences                   # Get user preferences\ntoggl me quota                         # Get API rate limit info\n\nOutput Formats\n\nAll list/get commands support --format option:\n\ntoggl te list --format json            # JSON output (default)\ntoggl te list --format table           # Human-readable table\ntoggl te list --format csv             # CSV for spreadsheets\n\nKey Concepts\nConcept\tPurpose\tExample\nTime Entries\tTrack time spent on tasks\t\"2 hours on Project X\"\nProjects\tGroup related time entries\t\"Website Redesign\"\nClients\tGroup projects by customer\t\"Acme Corp\"\nWorkspaces\tSeparate environments\t\"Personal\", \"Work\"\nTags\tCategorize entries\t\"billable\", \"meeting\"\nTasks\tSub-items within projects\t\"Design mockups\"\nAPI Reference\nBase URL: https://api.track.toggl.com/api/v9\nAuth: HTTP Basic with API token as both username and password\nRate Limits: 1 request/second (leaky bucket), 30-600 requests/hour (quota)\nCommon API Operations\n\nGet current user:\n\ncurl -u $TOGGL_API_TOKEN:api_token https://api.track.toggl.com/api/v9/me\n\n\nList time entries:\n\ncurl -u $TOGGL_API_TOKEN:api_token \\\n  \"https://api.track.toggl.com/api/v9/me/time_entries?start_date=2024-01-01&end_date=2024-01-31\"\n\n\nStart a timer:\n\ncurl -X POST -u $TOGGL_API_TOKEN:api_token \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"workspace_id\": 123, \"start\": \"2024-01-15T09:00:00Z\", \"duration\": -1, \"created_with\": \"curl\"}' \\\n  https://api.track.toggl.com/api/v9/workspaces/123/time_entries\n\n\nStop a timer:\n\ncurl -X PATCH -u $TOGGL_API_TOKEN:api_token \\\n  https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/time_entries/{entry_id}/stop\n\nNotes\nThe CLI handles rate limiting automatically with retry and exponential backoff.\nNegative duration on a time entry indicates a running timer.\nWhen using --start-date alone, --end-date defaults to now.\nUsing --end-date without --start-date will error (API requires both).\nAll timestamps are in ISO 8601 format."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/FroeMic/toggl-cli",
    "publisherUrl": "https://clawhub.ai/FroeMic/toggl-cli",
    "owner": "FroeMic",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}