toggl

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Toggl Track Skill

Simple and powerful time tracking with insights.

简单且功能强大的带洞察分析的时间追踪工具。

Quick Install

快速安装

bash

curl -sSL https://canifi.com/skills/toggl/install.sh | bash

Or manually:

bash

cp -r skills/toggl ~/.canifi/skills/

bash

curl -sSL https://canifi.com/skills/toggl/install.sh | bash

或者手动安装：

bash

cp -r skills/toggl ~/.canifi/skills/

Setup

设置

Configure via canifi-env:

bash

undefined

通过canifi-env进行配置：

bash

undefined

First, ensure canifi-env is installed:

curl -sSL https://canifi.com/install.sh | bash

canifi-env set TOGGL_API_TOKEN "your_token"

undefined

canifi-env set TOGGL_API_TOKEN "your_token"

undefined

Privacy & Authentication

隐私与认证

Your credentials, your choice. Canifi LifeOS respects your privacy.

你的凭证，由你掌控。 Canifi LifeOS 尊重你的隐私。

Option 1: Manual Browser Login (Recommended)

选项1：手动浏览器登录（推荐）

If you prefer not to share credentials with Claude Code:

Complete the Browser Automation Setup using CDP mode
Login to the service manually in the Playwright-controlled Chrome window
Claude will use your authenticated session without ever seeing your password

如果你不想与Claude Code共享凭证：

使用CDP模式完成浏览器自动化设置
在Playwright控制的Chrome窗口中手动登录该服务
Claude将使用你的已认证会话，全程不会看到你的密码

Option 2: Environment Variables

选项2：环境变量

If you're comfortable sharing credentials, you can store them locally:

bash

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.

如果你愿意共享凭证，可以将其存储在本地：

bash

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

注意：存储在canifi-env中的凭证仅能在你的本地机器上访问，绝不会被传输。

Capabilities

功能特性

Time Tracking: Start/stop timers
Reports: Generate time reports
Projects: Manage project tracking
Insights: AI-powered suggestions
Calendar Integration: Sync with calendars

时间追踪：启动/停止计时器
报告生成：生成时间报告
项目管理：管理项目追踪
洞察分析：AI驱动的建议
日历集成：与日历同步

Usage Examples

使用示例

Start Timer

启动计时器

User: "Start tracking development time"
Assistant: Starts Toggl timer

用户："开始追踪开发时间"
助手：启动Toggl计时器

View Today

查看今日时长

User: "How much have I worked today?"
Assistant: Returns daily time

用户："我今天工作了多久？"
助手：返回今日工作时长

Get Report

获取报告

User: "Show last week's report"
Assistant: Returns time breakdown

用户："显示上周的报告"
助手：返回时间明细

Add Project

添加项目

User: "Create a new project in Toggl"
Assistant: Creates project

用户："在Toggl中创建一个新项目"
助手：创建项目

Authentication Flow

认证流程

API token authentication
Basic auth with token
OAuth for integrations
Workspace-based

API令牌认证
基于令牌的基础认证
集成用OAuth
基于工作区的认证

Error Handling

错误处理

Error	Cause	Solution
Auth Failed	Invalid token	Check API token
Not Found	Wrong ID	Verify resource
Timer Conflict	Already running	Stop current
Forbidden	Workspace access	Check permissions

错误	原因	解决方案
认证失败	令牌无效	检查API令牌
未找到	ID错误	验证资源信息
计时器冲突	已有计时器在运行	停止当前计时器
禁止访问	工作区权限问题	检查权限设置

Notes

注意事项

AI insights (Toggl)
Pomodoro timer
Browser extension
100+ integrations
Detailed reports
Mobile apps

AI洞察分析（Toggl）
番茄钟计时器
浏览器扩展
100+集成
详细报告
移动应用