timesheet

What This Skill Does

The Timesheet CLI skill for OpenClaw integrates the powerful timesheet.io command-line interface directly into your AI workflow. It provides comprehensive tools for time tracking, project management, and reporting without ever needing to leave your terminal or IDE environment. Whether you are managing individual tasks, tracking billable hours for clients, or generating monthly summaries, this skill acts as a bridge between your work and your time management data. By leveraging structured JSON output, the skill ensures that OpenClaw can reliably process your work history and project metrics for further analysis or reporting.

Installation

To integrate this skill into your environment, use the OpenClaw management CLI: clawhub install openclaw/skills/skills/florianrauscha/timesheet Once installed, ensure your authentication is configured. You can either authenticate interactively using timesheet auth login or by exporting your API key as an environment variable: export TIMESHEET_API_KEY=ts_your.apikey. Always verify your connection status with timesheet auth status --json before initiating time-tracking tasks.

Use Cases

This skill is designed for freelancers, developers, and project managers who need to maintain accurate logs of their billable work. Common use cases include:

• Automating the transition between tasks throughout a busy day.
• Generating end-of-month client reports in CSV or XLSX formats directly from command history.
• Keeping project stakeholders informed by listing daily or weekly task summaries.
• Managing project scopes by creating and organizing tasks, tags, and team-based milestones.

Example Prompts

1. "Check if there is an active timer running and if not, start a new timer for the 'Design System' project."
2. "Generate a summary of all my billable work for this month and export it to a CSV file."
3. "List all my tasks for today and create a new tag named 'Client Review' for the project with ID 402."

Tips & Limitations

To maximize the efficiency of this skill, always rely on the --json flag when performing read operations to ensure OpenClaw accurately parses the data. For consistent productivity, set a default project ID using timesheet config set defaultProjectId <id>. Note that this skill requires an active internet connection to communicate with the timesheet.io API. Be cautious when handling sensitive project descriptions, as they are stored on the remote service provider's servers. Always double-check IDs before executing delete operations, as these actions cannot be undone via the CLI.