time-report

Aggregate session durations from JSON files into cross-project time reports.

2|1|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/lucidlabs-hq/lucidlabs-agent-kit --skill time-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: time-report
Source: https://github.com/lucidlabs-hq/lucidlabs-agent-kit/tree/main/.claude/skills/time-report
Command: npx skills add https://github.com/lucidlabs-hq/lucidlabs-agent-kit --skill time-report

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cross-project time reporting consolidates all session data into a single view, helping teams and individuals understand where time is spent.

Core Features & Use Cases

  • Load session data from ~/.claude-time/sessions and filter by period (all, this-week, this-month, last-month) or by {project-name}.
  • Aggregate per-project statistics, total time, and last active date, with cross-project totals.
  • Generate readable time reports suitable for reviews, planning, and productivity analysis.

Quick Start

Run the time-report tool to generate a cross-project time report from your local ~/.claude-time/sessions data.

Frequently Asked Questions about time-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I aggregate time across multiple projects for a specific period?

Cross-project time reporting consolidates session JSON data from ~/.claude-time/sessions into a single view, summarizing durations and per-project statistics to help you understand where time is spent across all projects.

Can I generate a cross-project time report for just one specific project?

Yes, you can generate a time report for a specific project by applying the {project-name} filter. The tool reads session data from ~/.claude-time/sessions and isolates individual project statistics including total time and last active date.

What time periods can I filter by when aggregating session time data?

When aggregating session time, you can filter by this-week, this-month, last-month, all, or a specific project name. These filters narrow the session data read from ~/.claude-time/sessions for targeted productivity analysis.

Do I need session JSON files to produce a cross-project time report?

Yes, the time report requires session JSON files stored locally in the ~/.claude-time/sessions directory. Without these files, the tool cannot aggregate durations or produce per-project statistics and cross-project totals.

What is the best way to review total time spent across all my projects?

Run a cross-project time report that loads local session data, summarizes per-project durations, and outputs cross-project totals alongside the last active date for each project, providing a single consolidated view for reviews and planning.