skills.rest
AnathemaOfficial
AnathemaOfficialCOMMUNITY
Explore all skills by this author →
Website𝕏@syfcorpofficialGitHub

punch

Record work session timestamps with location mapping to CSV files.

Updated Mar 31, 2026
Search Tags:#automation#csv#work-hours#time-tracking#idle-detection#punch#location-detection
One-click install
npx skills add https://github.com/AnathemaOfficial/claude-punch --skill punch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: punch
Source: https://github.com/AnathemaOfficial/claude-punch/tree/main/skills/punch
Command: npx skills add https://github.com/AnathemaOfficial/claude-punch --skill punch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Time tracking is often manual, error-prone, and easy to forget. Punch provides an automated way to record work sessions with timestamps and location data, reducing admin overhead.

Core Features & Use Cases

  • Automatic punch in/out to start and end a work session.
  • Manual away/back breaks within a session plus location-aware logging.
  • CSV-based log at ~/.claude/timelog/punches.csv with per-entry timestamp, type, location, and note.
  • Auto-location mapping from hostname to friendly names via ~/.claude/timelog/locations.json.
  • Status and reporting commands to monitor today, this week, and overall hours.

Quick Start

Say punch in to start a work session, or punch out to end it.

Frequently Asked Questions about punch

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

FAQPage Schema
How do I automate time tracking with location detection and idle monitoring?▼

Automated time tracking with location detection records punch in/out timestamps to a local CSV file, mapping hostnames to friendly location names, and using idle detection to manage away and back breaks within a work session.

Does automatic work session logging require any external database or cloud sync?▼

Automatic work session logging requires no external database or cloud sync. It relies entirely on local CSV storage at ~/.claude/timelog/punches.csv along with hostname-based location resolution and an autopunch configuration file.

How do I map my computer's hostname to a friendly location name for time logs?▼

To map hostnames to friendly location names for time logs, configure a JSON file at ~/.claude/timelog/locations.json. The time tracking system reads this file to automatically tag each punch in/out entry with your mapped location.

What is the best way to track work hours across multiple devices using a local CSV file?▼

Tracking work hours across multiple devices is supported by resolving device hostnames to specific friendly locations, logging all punch in/out events with timestamps to a central CSV file, and generating status reports for daily, weekly, and overall totals.

Can I enable idle-aware automation to automatically pause my time tracking?▼

Idle-aware automation to automatically pause time tracking can be enabled by configuring an autopunch file at ~/.claude/timelog/autopunch.json. This allows the system to detect inactivity and automatically manage away and back breaks.

Related Skills

Explore More Software Engineering Skills→
gyChen-3725gyChen-3725

system-info

Collects OS, Python version, hostname and more into a JSON snapshot via script.

Community
Basic
dEitY719dEitY719

make-jira

Parse work logs and generate weekly Jira reports in Markdown.

Community
Advanced
wuyyyyyouwuyyyyyou

recipe-backup-sheet-as-csv

Export a Google Sheets spreadsheet to a CSV file for local backup.

Community
Intermediate
adiytharpansaadiytharpansa

cloud-sync

Sync files across cloud storage platforms and automate backups.

Community
Intermediate