← Back to Skills Marketplace
37
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install time-guru
Description
Natural language time tracking with smart activity classification, multi-dimensional reports, productivity analytics, and billing.
README (SKILL.md)
Time Guru Skill
Zero-friction time tracking driven by natural language. Log activities by simply describing what you did. Get daily/weekly reports, productivity analysis, and billing summaries without remembering to start/stop timers.
Core Capabilities
- Natural Language Logging: "9点到11点写代码", "下午开了两小时的会"
- Instant Timer:
start/stopcommands with auto-duration - Retroactive Entry: Fill in past activities with fuzzy time parsing
- Smart Classification: Auto-categorize activities (dev, meeting, learning, etc.)
- Multi-Dimensional Reports: Daily, weekly, monthly, custom range
- Productivity Analytics: Peak hours, interruptions, deep work tracking
- Project/Customer Billing: Hourly rate × hours, exportable invoices
- Goal Tracking: Set daily/weekly time targets and monitor progress
Privacy & Storage
- All data stored locally at
~/.openclaw/data/time-guru/ - Organized as
YYYY/MM/DD.jsonfiles (one day per file) - Daily auto-backup (keeps last 7 backups)
- LLM only receives individual activity descriptions for parsing, never the full log
Usage
clawhub run time-guru \x3Caction> [options]
Actions
| Action | Description | Example |
|---|---|---|
log |
Log one or more activities | log "9-11写代码, 11-12开会" |
start |
Start a timer | start "写周报" --project report |
stop |
Stop the active timer | stop |
report |
Generate time report | report --period today |
analyze |
Productivity analysis | analyze --period this_week |
goal |
Set/check time goals | goal set development 4h/day |
project |
Project time summary | project list |
Report Options
| Option | Type | Default | Description |
|---|---|---|---|
--period |
enum | today |
today, yesterday, this_week, last_week, this_month, last_month, custom |
--date-from |
date | — | Custom range start |
--date-to |
date | — | Custom range end |
--group-by |
enum | category |
category, project, day, week |
--output-format |
enum | text |
text, json, csv, markdown |
--billing |
bool | false | Include billing info |
Sample Prompts
1. Natural language log (most common)
clawhub run time-guru log "9点到11点写后端API，11点到12点开需求评审会"
# → ✅ 2 activities logged
# ⏱ 09:00-11:00 (2h) 开发 · 写后端API
# ⏱ 11:00-12:00 (1h) 会议 · 需求评审会
# 📊 Today: 3h total
2. Instant timer mode
clawhub run time-guru start "写周报" --project company-report
# → ▶️ Timer started: 写周报 [company-report] @ 14:03
# ... later ...
clawhub run time-guru stop
# → ⏹ Stopped: 写周报 | Duration: 45 minutes
3. Daily report
clawhub run time-guru report --period today
# → 📊 Today's Time Report (Mon 2026-06-14)
# Development ████████████████████ 4.5h (52.9%)
# Meeting ██████████▌ 2.0h (23.5%)
# Documentation ██████ 1.0h (11.8%)
# Break ██████ 1.0h (11.8%)
# 💰 Billable: 6.5h × ¥500/h = ¥3,250
4. Weekly productivity analysis
clawhub run time-guru analyze --period this_week
# → 📈 Weekly Analysis
# 🔥 Peak hours: 09:00-11:00 (34% of output)
# 🧠 Deep work: 12.5h this week (↑ 15% vs last week)
# ⚠️ Task switches: 7/day (high)
# 💡 Recommendation: Block 14:00-16:00 for meetings
5. Billing report
clawhub run time-guru report --period this_month --billing
# → 💰 Monthly Billing (June 2026)
# Project A (XYZ Corp) · 35h × ¥500 = ¥17,500
# Project B (ABC Inc) · 22h × ¥600 = ¥13,200
# Internal · 18h × ¥0 = ¥0
# ────────────────────────────────────────
# Total billable: ¥30,700
First-Success Path
Step 1: Install → clawhub install time-guru
Step 2: Log → clawhub run time-guru log "刚才一直在写代码2小时"
Step 3: Confirm → see activity logged with auto-classification
Step 4: Report → clawhub run time-guru report --period today
Step 5: Insight → see where time went → habit-forming value
Core Scripts
| File | Purpose |
|---|---|
scripts/__init__.py |
Package init |
scripts/nl_parser.py |
Natural language time parsing |
scripts/timer.py |
Start/stop timer management |
scripts/logger.py |
Data persistence (JSON files) |
scripts/classifier.py |
Activity auto-classification |
scripts/reporter.py |
Daily/weekly/monthly reports |
scripts/analyzer.py |
Productivity analysis engine |
scripts/goal_tracker.py |
Time goal setting and tracking |
scripts/bill_calculator.py |
Billing calculation |
scripts/importer.py |
External data import |
scripts/exporter.py |
Data export (CSV/JSON) |
scripts/reminder.py |
Daily/weekly reminders |
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install time-guru - After installation, invoke the skill by name or use
/time-guru - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Time Guru for natural language time tracking and productivity analysis.
- Effortless activity logging with smart auto-classification and instant timer support.
- Generate multi-dimensional reports (daily, weekly, monthly) and advanced productivity analytics.
- Retroactive activity entry and billing/invoicing features for projects and clients.
- Local, privacy-friendly storage with optional reminders and backup.
Metadata
Frequently Asked Questions
What is Time Guru?
Natural language time tracking with smart activity classification, multi-dimensional reports, productivity analytics, and billing. It is an AI Agent Skill for Claude Code / OpenClaw, with 37 downloads so far.
How do I install Time Guru?
Run "/install time-guru" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Time Guru free?
Yes, Time Guru is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Time Guru support?
Time Guru is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Time Guru?
It is built and maintained by haidong (@harrylabsj); the current version is v1.0.0.
More Skills