File Changes Tracker

This skill helps you track and analyze recent file modifications in your workspace. It provides a comprehensive view of files changed in the last 7 days, sorted by modification date to help you understand recent development activity.

Quick Start

To list all files changed in the current workspace in the last week:

python scripts/list_recent_changes.py

For a different workspace path:

python scripts/list_recent_changes.py --path /path/to/workspace

For JSON output (useful for further processing):

python scripts/list_recent_changes.py --json

How It Works

The skill uses git log to analyze commit history and identify files that have been modified. It:

Scans git history for the last 7 days using git log --since="1 week ago"
Tracks file modifications and keeps the most recent change for each file
Sorts by date with the most recently modified files first
Provides detailed information including modification date, author, and commit hash

Output Format

The default output shows:

File path (truncated if very long)
Last modification date and time
Author of the change
Commit hash (shortened)

Example output:

Files changed in the last week (ordered by most recent modification):
================================================================================
src/main.py                 2024-12-26 14:30  John Doe     abc1234
README.md                   2024-12-25 09:15  Jane Smith   def5678
config/settings.json        2024-12-24 16:45  John Doe     ghi9012

Total: 3 files changed

Use Cases

Development tracking: See what files you've been working on recently
Code review preparation: Identify files that need review
Progress reporting: Show recent development activity
File cleanup: Find files that may need attention
Collaboration: Share recent changes with team members

Requirements

Must be run in a git repository
Git must be installed and accessible
Python 3.6+ required

Script Options

--path PATH: Specify a different workspace directory (default: current directory)
--json: Output results in JSON format for programmatic use

Troubleshooting

"Error: [path] is not a git repository"

Ensure you're running the script in a directory that's a git repository
Use --path to specify the correct repository location

No files shown

Check if there have been any commits in the last week
Verify the repository has recent activity

Permission errors

Ensure you have read access to the git repository
Check that git commands work in your terminal