An intelligent, local-first time tracking tool driven by natural language parsing and automated activity classification.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install time-guru
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install time-guru using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Time Guru?
Time Guru is a zero-friction, local-first time tracking and productivity analysis tool that runs directly on your terminal. Designed to remove the overhead of starting and stopping timers manually, this application leverages a DeepSeek-v4-flash LLM to parse natural language logs, allowing developers and professionals to record activities retroactively using conversational expressions. As a stellar addition to the ecosystem of Openclaw Skills, it automates daily logging, project classification, and billing reports.
All captured data remains fully private, stored locally on your machine in daily JSON files. With features spanning multi-dimensional reporting, goal tracking, and productivity analytics (such as deep work tracking and task-switching metrics), Time Guru helps you gain a comprehensive understanding of your workday without compromising security or manual logging time.
Time Guru Use Cases
- Retroactive Time Logging: Easily log hours worked throughout the day using conversational language like "wrote backend API from 9 to 11 and reviewed PRs for an hour".
- Automated Client Billing: Generate hourly rate summaries and exportable invoice metrics directly from categorized project work.
- Focus and Productivity Analysis: Evaluate deep work hours, identify peak productivity times, and notice task-switching friction.
- Daily and Weekly Progress Tracking: Set target hourly goals per category (such as 4 hours/day of development) and monitor real-time compliance.
- Local-First Private Auditing: Maintain a fully secure, locally managed history of your professional activity logs with zero reliance on cloud databases.
How Time Guru Works
- Input Collection: You initiate a log using natural language (e.g.,
clawhub run time-guru log "9 to 11 coding") or start a real-time timer. - Natural Language Parsing: The system utilizes a specialized script (
nl_parser.py) powered by deepseek/deepseek-v4-flash to parse time spans, durations, and activity descriptions. - Smart Classification: Your activities are auto-categorized into preset segments (e.g., development, meetings, learning) through
classifier.py. - Local Persistence: Data is written into clean JSON files segmented by day (e.g.,
YYYY/MM/DD.json) within the local user directory. - Analysis & Reporting: When requested, reporting and analysis scripts evaluate local records to compile productivity summaries, peak-hour insights, and billable charts.
Time Guru Setup
To install and get started with this project from the available list of Openclaw Skills, execute the following commands in your CLI:
# Step 1: Install the skill
clawhub install time-guru
# Step 2: Log your first activity using natural language
clawhub run time-guru log "9点到11点写代码, 11点到12点开会"
# Step 3: Run a daily report to confirm
clawhub run time-guru report --period today
Time Guru Data Schema & Taxonomy
Time Guru prioritizes local privacy and schema-driven consistency. All files are organized cleanly in your local profile.
Directory Structure
- Path:
~/.openclaw/data/time-guru/ - File Structure:
/YYYY/MM/DD.json(one file per calendar day)
Data Storage Blueprint
| Component | File Path / Extension | Details |
|---|---|---|
| Daily Logs | ~/.openclaw/data/time-guru/YYYY/MM/DD.json |
Stores activities, categorized tags, durations, and projects. |
| Auto-Backups | Managed locally | Maintains the last 7 daily automatic backups. |
| Core Schemas | schemas/input.schema.json, schemas/output.schema.json |
Validates time inputs, CLI parameters, and JSON output formatting. |
Time Guru Advanced Features
- Hourly Rate & Billing Calculation: Automatically calculate and present project billing breakdowns with flags like
--billing. - Productivity Analytics Engine: Compute metrics for focus peaks, task switching, and deep work trends using
scripts/analyzer.py. - Multi-Format Exporting: Export compiled reports directly to CSV, plain text, custom Markdown, or clean JSON interfaces.
- Custom Goal Tracking: Define category-specific goals (such as 4 hours of development daily) and receive status flags during report generations.
- Automated Retention & Backups: Securely preserves records with integrated local data rotations holding up to 7 historical snapshots.
SKILL.md
Loading
Related Openclaw Skills
Unbearable Lightness - Eating Disorder Recovery & Memoir Guide
An AI-powered mental health companion based on Portia de Rossi's memoir, designed to navigate eating disorder recovery, body dysmorphia, and psychological healing.
arXiv Paper with Diagram
An advanced AI agent skill designed to parse, translate, and extract high-quality structural and model diagrams from arXiv academic papers.
last30days-glim
A 30-day social and web research briefing agent that pulls, ranks, and synthesizes real-world engagement data across 11+ platforms using a single Glim API key.
Xiaohongshu Note Booster
An automated social media marketing engine that instantly generates three viral-ready Xiaohongshu (Little Red Book) notes with optimized titles, hashtags, and visual guides from a single prompt.
SQL Buddy
An AI-powered database companion that translates natural language into secure, optimized SQL queries and provides intelligent database schema insights.
Pixel2Motion
An advanced Openclaw Skills agent tool designed to convert raster logo images into optimized, minimal vector SVGs and animate them using professional Disney animation principles inside custom showcase HTML.
Featured*
