agents-radar: Instructions file for Claude Code

CLAUDE.md

Project overview

agents-radar is a daily digest generator for the AI open-source ecosystem. A GitHub Actions cron job runs at 22:37 UTC (06:37 CST next day) and produces bilingual (Chinese + English) reports, published as GitHub Issues and committed Markdown files.

Commands

pnpm start          # run the full digest locally
pnpm test           # vitest (unit tests)
pnpm typecheck      # tsc --noEmit
pnpm lint           # ESLint
pnpm lint:fix       # ESLint --fix
pnpm format         # Prettier --write src
pnpm format:check   # Prettier --check src

Required env vars for local runs:

export GITHUB_TOKEN=ghp_xxxxx
export DIGEST_REPO=owner/repo   # omit to skip GitHub issue creation

# LLM provider (default: anthropic)
export LLM_PROVIDER=anthropic   # anthropic | openai | github-copilot | openrouter | deepseek | qwen

# Anthropic (default)
export ANTHROPIC_API_KEY=sk-ant-xxxxx

# OpenAI
# export OPENAI_API_KEY=sk-xxxxx

# GitHub Copilot — uses GITHUB_TOKEN

# OpenRouter
# export OPENROUTER_API_KEY=sk-or-xxxxx

# DeepSeek
# export DEEPSEEK_API_KEY=sk-xxxxx

# Qwen (Alibaba Model Studio) — provider used by the GitHub Actions cron
# export DASHSCOPE_API_KEY=sk-xxxxx

Architecture

The pipeline runs in five sequential phases, each implemented as a named async function in src/index.ts:

1. fetchAllData — all network I/O in parallel: GitHub API (issues/PRs/releases) for 18 repos, Claude Code Skills, Anthropic/OpenAI sitemaps, GitHub Trending HTML + Search API, Hacker News Algolia API.
2. generateSummaries — per-repo LLM calls in English only, all in parallel, rate-limited to 5 concurrent requests by a queue in src/report.ts.
3. translateSummaries — translates the English bodies to Chinese via translateToZh.
4. Comparisons — three English LLM calls (cross-tool CLI, OpenClaw cross-ecosystem, infra), each then translated.
5. Save phase — buildCliReportContent / buildOpenclawReportContent / buildInfraReportContent (in src/report-builders.ts) build Markdown strings; the saveXxxReport functions (in src/report-savers.ts) generate their body in English, translate it, then write both language files and create both GitHub Issues.