numbers

Public dashboard of engineering activity across the OSIX-Tech GitHub organization.

Repo layout

• aggregator/ — Python tool that scrapes the org and emits web/public/data.json.
• web/ — Vite + React dashboard that reads that JSON.
• scripts/refresh.sh — local weekly cron entrypoint.

Local development

Aggregator

cd aggregator
uv sync
GH_TOKEN=$(gh auth token) uv run python -m osix_numbers

Output: web/public/data.json.

Web

cd web
pnpm install
pnpm dev

Spec & plan

See docs/superpowers/specs/ and docs/superpowers/plans/.

Weekly refresh

scripts/refresh.sh is the cron entrypoint. It pulls latest, runs the aggregator, commits the refreshed data.json, and pushes.

Install on macOS / Linux

chmod +x scripts/refresh.sh

# Edit your crontab:
crontab -e

# Add this line (Mondays 06:00 local time):
0 6 * * 1 /Users/<you>/osix/numbers/scripts/refresh.sh

Logs land in ~/.local/state/osix-numbers/refresh-*.log.

⚠️ The script does git reset --hard origin/main before running, so any uncommitted local edits in ~/osix/numbers/ will be wiped. Don't develop in this checkout — use a separate worktree if needed.

Manual run

scripts/refresh.sh
tail -f ~/.local/state/osix-numbers/refresh-*.log

Stop scheduling

crontab -e and delete the line.

Deployment (manual, when ready)

The repo ships web/vercel.json so deployment is one command.

cd web
pnpm dlx vercel link    # set root directory to "./" when asked
pnpm dlx vercel --prod

After that, every push to main (including the cron's data.json refresh commits) auto-deploys via Vercel's normal pipeline. No env vars required.

If Vercel writes a .vercel/ folder, it's already gitignored.