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

Ready to run

npx skills add https://github.com/AnathemaOfficial/claude-punch --skill punch

💬 Prompt for ChatGPT / Claude Chat▼

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.