timecamp

What This Skill Does

The TimeCamp skill for OpenClaw provides a comprehensive interface for managing time-tracking workflows directly from your terminal. It bifurcates functionality into two specialized modules: a CLI for rapid, day-to-day personal time management (starting/stopping timers, manual entries, and task listing) and a Data Pipeline for deeper analytical insights. By integrating these tools, users can transition seamlessly from active task management to historical data reporting, allowing for efficient tracking of professional activities and granular analysis of productivity patterns.

Installation

To integrate this skill, use the command: clawhub install openclaw/skills/skills/kamil-rudnicki/timecamp. Before full functionality is reached, the agent will verify if your local environment is configured. You will be prompted to define a workspace directory (defaulting to ~/utils) where the timecamp-cli and good-enough-timecamp-data-pipeline repositories will be cloned. Ensure you have git and uv installed, as these are prerequisites for the tool's installation and operational scripts.

Use Cases

This skill is ideal for professionals who need to maintain rigorous timesheets or project managers who need to extract data for performance reviews. Use the CLI to log hours in real-time while working in a terminal environment. Utilize the Data Pipeline for extracting structured datasets (like computer activities or project hierarchies) into JSONL files, which can then be imported into BI tools or custom reporting dashboards to analyze resource allocation and project efficiency over specific timeframes.

Example Prompts

1. "Start a timer for 'Project A' with a note: 'Implementing user authentication module'."
2. "Show me all entries for this week and generate a report of my computer activities for the last 5 days using the pipeline."
3. "Update the duration of my entry with ID 101234 to exactly one hour and remove the draft entry from yesterday."

Tips & Limitations

Always verify your path before cloning the repositories to avoid cluttering your root directory. The pipeline requires uv to manage dependencies; ensure your virtual environments are clean if you encounter runtime errors. Remember that CLI commands execute immediately, while the Data Pipeline involves a brief wait for the extraction process to complete. Files produced by the pipeline are stored in ~/data/timecamp-data-pipeline/timecamp/*.jsonl, making them perfect for downstream processing with Python or SQL.