Skill

logbook:time

Analyze time spent per project across all Claude Code sessions. Generates monthly and yearly markdown reports with per-project/branch breakdowns. Use when the user asks about "time spent", "hours per project", "session time", "time report", "logbook time", or wants to know how long they spent coding.

Install

npx claudepluginhub florianbuetow/claude-code --plugin logbook

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Generate time-per-project reports from Claude Code session logs. Groups branches under their parent project. Excludes idle gaps > 15 minutes.

SKILL.md

Similar Skills

using-git-worktrees

Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.

superpowers

168.3k

subagent-driven-development

3 files

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

superpowers

168.3k

dispatching-parallel-agents

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

superpowers

168.3k

Stats

Parent Repo Stars8

Parent Repo Forks0

Last CommitMar 30, 2026

Actions

View Source View Plugin View on GitHub View README

Logbook — Time Report

Generate time-per-project reports from Claude Code session logs. Groups branches under their parent project. Excludes idle gaps > 15 minutes.

Workflow

Step 1: Run the analysis script

The script lives at the plugin path. Find it relative to this skill:

SCRIPT="$(dirname "$(dirname "$(dirname "$0")")")/scripts/logbook.py"

But in practice, run it from the project root:

python3 plugins/logbook/scripts/logbook.py time --out docs/reports

This generates:

One file per calendar month: YYYYMM-logbook-time.md
One file per year: YYYY-logbook-time.md

To limit to a specific period:

python3 plugins/logbook/scripts/logbook.py time --year 2026 --month 3 --out docs/reports

For preview only (no files written):

python3 plugins/logbook/scripts/logbook.py time --preview

Step 2: Show the preview

After running the script, display the top 10 table from stdout directly to the user. This is the inline preview — do NOT hide it behind a file path.

Step 3: List generated files

Show the user which report files were created and their paths.

Report Structure

Each report contains:

Summary — total active time, project count, session count
Top 10 table — project name + time
Detailed breakdown — every project with branch-level rows showing time and session counts

Notes

Gaps > 15 minutes between messages are excluded (configurable in script as GAP_THRESHOLD)
Branches are detected from git worktree patterns (-git-<branch>, --claude-worktrees-<branch>)
Excluded projects are configured in the EXCLUDED list in the script