A versatile command-line utility for logging, tracking, and managing time-related entries with built-in search and export capabilities.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install stopwatch
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 stopwatch 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 Stopwatch?
Stopwatch is a robust, lightweight utility toolkit designed for developers who need to log and manage time-related data directly from the terminal. As a specialized component of Openclaw Skills, it provides a file-based logging system that records timestamped entries for various activities ranging from performance analysis to task tracking. By leveraging standard POSIX utilities, Stopwatch offers a high-performance alternative to heavy GUI time-trackers, ensuring your data remains local, portable, and easily accessible.
The tool is built to support complex workflows by categorizing logs into specific domains such as runs, checks, conversions, and reports. Whether you are monitoring system processes or manual work intervals, this utility ensures that every action is documented with precision, making it an essential addition to any developer's Openclaw Skills collection.
Stopwatch Use Cases
- Tracking timed activities and deep work sessions for better time management.
- Comparing performance metrics across different software versions or build runs.
- Logging batch processing outcomes and bulk operations for auditing.
- Integrating automated status checks into CI/CD pipelines or cron jobs.
- Generating structured historical reports for project stakeholders using export features.
How Stopwatch Works
- The user triggers a command such as run, check, or analyze followed by a description or data input.
- The system generates a precise timestamp and formats the entry as YYYY-MM-DD HH:MM|input.
- Data is appended to both a command-specific log file and a master activity history file.
- If a command is run without arguments, the utility retrieves and displays the 20 most recent entries from that specific log.
- Advanced search and statistics commands parse these local files to provide insights or export data into JSON and CSV formats.
Stopwatch Setup
Stopwatch is designed for immediate use on Linux and macOS systems with Bash 4.0+ installed. Follow these steps to get started:
# Move the script to your local bin and make it executable
chmod +x stopwatch
# (Optional) Define a custom storage location
export STOPWATCH_DIR="~/.local/share/stopwatch/"
# Verify the installation
stopwatch version
Stopwatch Data Schema & Taxonomy
All information is stored locally in the user's home directory to maintain privacy and speed. The data is organized in a flat-file taxonomy:
| File Name | Data Description |
|---|---|
| history.log | The master archive of every entry logged by any command. |
| run.log | Dedicated log for execution and runtime entries. |
| analyze.log | Records specifically related to performance analysis and metrics. |
| export.json/csv | Structured data output generated for external tool integration. |
Each entry within these logs uses the pipe-delimited format: YYYY-MM-DD HH:MM|input_string.
Stopwatch Advanced Features
- Global full-text search across all categorized logs using case-insensitive matching.
- Comprehensive summary statistics providing entry counts and storage utilization metrics.
- Multi-format export engine supporting JSON and CSV for seamless integration with other Openclaw Skills.
- Environment variable overrides for flexible data directory management (STOPWATCH_DIR).
- Minimalist dependency model relying exclusively on native POSIX utilities like grep, sed, and tail.
SKILL.md
Loading
Related Openclaw Skills
Prompt Compress
A sophisticated prompt engineering tool designed to analyze, extract, and compress long instructions into high-density, token-efficient formats.
English-Chinese Translation (translate-en-zh)
A professional bidirectional translation skill for seamless English-Chinese conversion across text, code comments, and technical documentation.
Scientific Citation Network and Knowledge Mapper
A sophisticated tool for mapping scientific research lineage and identifying influential papers through advanced citation network analysis.
FusionAlpha A&Crypto Desk
A professional-grade analytical skill for providing high-conviction, data-anchored reports for both Chinese A-shares and cryptocurrency markets.
GuanXing: Chinese Metaphysics AI
A comprehensive Chinese metaphysics AI toolkit for BaZi birth charts, daily fortunes, crypto luck, and spiritual divination.
wttr-weather
A comprehensive command-line tool for retrieving weather forecasts, astronomical data, and custom terminal-formatted weather reports.
Featured*
