lucidlabs-hq/.claude/skills/time-report

Time Report: Cross-Project Session Overview

Objective

Read ALL session files from ~/.claude-time/sessions/*.json and produce an aggregated time report. Supports filtering by period or project name.

---

Arguments

| Argument | Description | |----------|-------------| | all (default) | All sessions ever recorded | | this-week | Current calendar week (Monday-Sunday) | | this-month | Current calendar month | | last-month | Previous calendar month | | {project-name} | Filter to a specific project |

---

Process

1. Load All Session Data

TIME_DIR="$HOME/.claude-time"
SESSIONS_DIR="$TIME_DIR/sessions"
DEVELOPER_FILE="$TIME_DIR/developer.json"

# List all session files
ls "$SESSIONS_DIR"/*.json 2>/dev/null

# Read developer name
DEVELOPER_NAME=$(cat "$DEVELOPER_FILE" 2>/dev/null | grep '"name"' | cut -d'"' -f4)

2. Parse Each Session File

For each *.json in $SESSIONS_DIR:

• The filename (without .json) is the project name
• Read the sessions array
• Each entry has: date, start, end, duration_minutes, recovered (optional), synced_to_productive

3. Apply Filter

Based on the argument:

| Filter | Logic | |--------|-------| | all | No filtering | | this-week | Compare date to current week range | | this-month | Compare date to current month (YYYY-MM) | | last-month | Compare date to previous month (YYYY-MM) | | {project} | Only read sessions/{project}.json |

4. Aggregate

For each project:

• Count sessions
• Sum duration_minutes
• Find last active date
• Count recovered sessions

Cross-project totals:

• Total sessions
• Total time
• Total recovered

5. Format Duration

Convert minutes to human-readable:

85 min  → 1h 25min
210 min → 3h 30min

---

Output Format

TIME REPORT                                    Developer: {name}
Period: {filter description}                   Generated: {date}
────────────────────────────────────────────────────────────────────
Project                     Sessions    Total Time     Last Active
────────────────────────────────────────────────────────────────────
n8n-v2-migration            1           1h 37min       2026-02-11
client-service-reporting    3           5h 15min       2026-02-10
cotinga-test-suite          7           12h 45min      2026-02-09
────────────────────────────────────────────────────────────────────
TOTAL                       11          19h 37min

RECOVERED: 2 sessions (approximate duration marked with ~)

────────────────────────────────────────────────────────────────────
Sessions data: ~/.claude-time/sessions/

If Project-Specific Filter

When filtering by project name, show individual sessions:

TIME REPORT: {project-name}                    Developer: {name}
Period: all                                    Generated: {date}
────────────────────────────────────────────────────────────────────

Date          Start    End      Duration    Ticket     Status
────────────────────────────────────────────────────────────────────
2026-02-11    02:33    04:10    1h 37min    -          pending
2026-02-10    14:00    17:30    3h 30min    CUS-42     synced
2026-02-09    09:15    11:00    1h 45min    CUS-41     pending
────────────────────────────────────────────────────────────────────
TOTAL: 3 sessions, 6h 52min

Recovered: 1 session (~)     Synced: 1     Pending: 2

---

Edge Cases

| Case | Handling | |------|----------| | No session files exist | Show: "No sessions recorded yet. Start tracking with /prime." | | Project not found | Show: "No sessions found for project '{name}'." | | Recovered sessions | Mark with ~ prefix on duration, count separately | | Zero duration | Show as < 1min | | Session file corrupted | Skip with warning: "Could not parse {file}" |

---

No Productive.io Sync

This skill is read-only. It does NOT sync to Productive.io. For syncing, use /time-sync (future feature).