research

CLI research tool using claude.ai via playwriter browser automation. Fires research prompts against Haiku with web search, polls for completion, downloads results.

Requirements

• Bun or Node.js ≥18
• Chrome with playwriter extension active on a claude.ai tab
• creds.json with your org ID (see Setup)

Setup

1. Get credentials

bun refresh-auth.js

This captures your session from Chrome and writes creds.json. Re-run when you get 401/403 errors.

2. Single research prompt

bun research.js "research all improvements for github.com/AnEntrypoint/gm"

Optional env vars:

• CLAUDE_MODEL — default claude-haiku-4-5-20251001
• THINK_BUDGET — extended thinking tokens, default 10000 (set 0 to disable)

3. Retrieve a conversation

bun retrieve.js --last-run          # last research.js run
bun retrieve.js --latest            # most recent conversation
bun retrieve.js <conv-uuid>         # specific conversation
bun retrieve.js --list 20           # list 20 recent conversations

Batch workflow

jobs.json — array of { repo, convId } entries. convId is populated after submit.

bun batch.js status                 # check which jobs are complete
bun batch.js wait [interval_sec]    # poll until all complete (default 15s)
bun batch.js download               # save results to results/
bun batch.js run [interval_sec]     # wait + download in one go

Results saved to results/<repo>.md. Multi-turn completions are assembled across turns automatically.

creds.json

{
  "orgId": "<your-org-uuid>"
}

Never commit this file — it is gitignored.