Skip to content

CLAUDE.md

Latest commit

 

History

History
37 lines (28 loc) · 1.48 KB

CLAUDE.md

File metadata and controls

37 lines (28 loc) · 1.48 KB
Raw

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

What this is

A single-page dashboard for weekly dev calls. It pulls PRs and issues from one or more GitHub orgs/users and renders one HTML page summarising the week's activity: merged/opened PRs, new/closed issues, currently-open PRs and assigned issues. Built on Bun with a tiny custom JSX-to-HTML renderer — no database, no client framework, no build step.

Commands

bun install
bun run serve   # http://localhost:4477
bun run dev     # same, with auto-reload
bun run test    # bun test
bun run format  # biome: apply lint fixes + formatting

A pre-commit hook runs lint + typecheck + tests (self-installs on bun install).

Needs a GitHub token: GITHUB_TOKEN in .env, else falls back to gh auth token. Configure owners and window in .env (see .env.example).

Key files

  • src/github.ts — all GitHub access (GraphQL search). Builds the Digest: the week-scoped lists vs. openPRs/assignedIssues, which reflect today's live state regardless of the selected week.
  • src/page.tsx — the entire view (all components, CSS, and the inline client-side filtering JS). By far the largest file; most UI work happens here.
  • src/server.ts — Bun HTTP server, single / route, 60s HTML cache.
  • src/range.ts — date-window maths driven by the ?end= query param.
  • src/jsx.ts — the custom JSX runtime (h/Fragment/raw).