Activity Report

A developer activity dashboard that scans your local git repos and displays commits, PRs, and stats as a static site. Run it locally, deploy to GitHub Pages, or host on Cloudflare Pages.

Preview: https://pulse.automem.ai

Quick Start

# Generate the report (scans ~/Projects and ~/Local Sites by default)
node generate-rich-report.mjs --paths ~/Projects --no-prs

# View it
npx http-server -p 8080
# Open http://localhost:8080

That's it. You should see your commit activity for the last 7 days.

Prerequisites

• Node.js v18+
• git
• Optional: GitHub CLI (gh) for PR details

Configuration

CLI Flags

node generate-rich-report.mjs \
  --paths ~/Projects,~/code \    # Comma-separated scan roots
  --hours 48 \                   # Time window (default: 168 = 7 days)
  --max-depth 4 \                # Repo scan depth
  --author you@example.com \     # Filter commits by email
  --gh-author someuser \         # GitHub PR author filter
  --exclude "vendor,archive" \   # Exclude repos matching patterns
  --no-prs                       # Skip PR fetching (no gh CLI needed)

config.json (Optional)

Create a config.json in the repo root for persistent settings (see config.json.example):

{
  "paths": ["~/Projects", "~/code"],
  "author": "you@example.com",
  "ghAuthor": "your-github-username",
  "exclude": ["node_modules", "vendor"],
  "hours": 168
}

CLI flags override config.json values.

Environment Variables

These also work as alternatives to CLI flags:

• ACTIVITY_REPORT_AUTHOR_EMAIL — commit author filter
• ACTIVITY_REPORT_GH_AUTHOR — GitHub PR author filter
• GH_TOKEN — GitHub token for PR fetching

If no author is specified, it falls back to your git config user.email.

Categories (Optional)

Create a categories.json to group repos in the dashboard (see categories.json.example):

{
  "Frontend": { "icon": "🖥️", "class": "frontend", "repos": ["my-app", "website"] },
  "Backend": { "icon": "⚙️", "class": "backend", "repos": ["api", "worker"] }
}

Repos not in any category appear in an "Other" group. If no categories.json exists, all repos are shown ungrouped.

PR Fetching

If you want PRs included in the report:

1. Install GitHub CLI: brew install gh
2. Authenticate: gh auth login (or set GH_TOKEN)
3. Run without --no-prs

By default it searches PRs authored by @me. Override with --gh-author yourname.

Hosting Options

Local Only

npm run generate     # Generate the report
npm start            # Serve at http://localhost:8080

Use npm run generate:cached for faster re-renders from cached data.

GitHub Pages (Free)

The included .github/workflows/github-pages.yml workflow deploys to GitHub Pages. It runs on GitHub-hosted runners (no self-hosted runner needed), but can only scan commits in the repo itself.

1. Go to repo Settings > Pages > Source: GitHub Actions
2. Run the workflow manually (Actions > Activity Report (GitHub Pages) > Run workflow)
3. To automate: uncomment the schedule trigger in the workflow file

Cloudflare Pages (with Self-Hosted Runner)

For scanning local repos on your machine, use .github/workflows/daily-update.yml with a self-hosted runner.

1. Set up a self-hosted runner on your machine
2. Configure repository variables (Settings > Variables):
   • SCAN_PATHS — paths to scan (e.g. ~/Projects,~/code)
   • GH_AUTHOR — your GitHub username
   • GIT_EMAIL — email for automated commits
   • GIT_NAME — name for automated commits
   • CLOUDFLARE_DEPLOY — set to true to enable Cloudflare deployment
   • CLOUDFLARE_PROJECT — Cloudflare Pages project name
3. Add secrets: CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID

How It Works

1. generate-rich-report.mjs recursively scans directories for .git repos
2. Extracts commits via git log with author filtering
3. Optionally fetches PR details via gh CLI
4. Outputs activity-data.json (cached data)
5. index.html loads activity-data.json at runtime — it's a static vanilla JS dashboard, no build step

Scripts

npm run generate         # Generate fresh report
npm run generate:cached  # Use cached activity-data.json
npm start                # Serve locally on port 8080
npm test                 # Smoke test (generates into temp dir, cleans up)

License

MIT