Clone Autoresearch

Run autonomous AI research on any subject. One command installs everything, generates research questions, and starts Claude researching with verified citations.

Terminal

$ git clone https://github.com/danlex/autoresearch-starter.git my-research

$ cd my-research

$ bash install.sh

View on GitHub Use This Template

What You Get

🔍

AI Research

Claude searches the web, writes findings with inline [N] citations, verifies every claim through three judges.

🌐

Published Website

Modern Astro site with WebGL particles, glassmorphism, search, dark/light mode. Auto-deploys to GitHub Pages.

📊

Full Transparency

Every task, PR, judge review, and source is public on GitHub. Research score tracks progress to 100%.

How It Works

1

Define your subject

Edit goal.md — who or what to research, what areas to cover, what "done" looks like.

2

Run install

bash install.sh — installs deps, authenticates, generates 30-50 research questions as GitHub Issues.

3

Research runs autonomously

Claude Code picks tasks, searches the web, writes findings with citations. Three judges review. PRs auto-merge. Score climbs.

4

Website publishes automatically

After each iteration, the site rebuilds and deploys to GitHub Pages with all findings, sources, and progress.

What is Claude Code?

Claude Code is Anthropic's CLI tool that lets Claude operate directly in your terminal — reading files, running commands, searching the web, and writing code. Autoresearch runs entirely inside Claude Code.

You don't need to interact with Claude manually. The research scripts call claude -p (programmatic mode) automatically — Claude searches the web, writes findings, and edits files autonomously.

Install Claude Code:

$ npm install -g @anthropic-ai/claude-code

$ claude auth login   # authenticate once

$ claude --version    # verify

GitHub Setup

1. Create Your Repository

Click "Use this template" on GitHub, or clone manually:

$ git clone https://github.com/danlex/autoresearch-starter.git my-research

$ cd my-research

$ gh repo create my-username/my-research --public --source . --push

2. Enable GitHub Pages

This publishes your research website automatically.

  1. Go to your repo on GitHub
  2. Click Settings (gear icon)
  3. Scroll to Pages in the left sidebar
  4. Under Source, select Deploy from a branch
  5. Set branch to main and folder to /docs
  6. Click Save

Your site will be live at: https://your-username.github.io/my-research/

3. Labels & Issues (automatic)

When you run bash install.sh, it automatically:

  • Creates 20+ labels (task, accepted, priority-high, type-research, etc.)
  • Generates 30-50 research questions as GitHub Issues
  • Accepts high-priority tasks to start immediately

You don't need to configure anything manually — the scripts handle all GitHub setup via the gh CLI.

Requirements

Claude Authentication (pick one)

Option A: OAuth Token (recommended)

Free with your Claude account. No API billing needed.

$ npm install -g @anthropic-ai/claude-code

$ claude auth login

# Opens browser → sign in → token saved automatically

$ claude auth status

# Shows: Authenticated as your@email.com

Or set manually in .env:

CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-...

Option B: API Key

Pay-per-use. Best for heavy research sessions.

  1. Go to console.anthropic.com
  2. Sign up or log in
  3. Go to API Keys in the left sidebar
  4. Click Create Key, copy it
  5. Add to .env:

ANTHROPIC_API_KEY=sk-ant-api03-...

GitHub Account

Required for task management (Issues), code history (PRs), and website hosting (Pages).

Install and authenticate the GitHub CLI:

$ brew install gh    # macOS

$ gh auth login     # opens browser

System

macOS or Linux. The installer handles all dependencies automatically:

Auto-installed

  • Node.js 22+
  • GitHub CLI (gh)
  • Claude Code CLI
  • jq (JSON processor)

Optional

  • ShellCheck (linting)
  • VS Code (editing)
  • Custom domain (SEO)

Research Any Subject

Autoresearch works for people, companies, technologies, events — anything with public information.

Albert Einstein

Physics, relativity, Nobel Prize

SpaceX

Rockets, Starship, Mars mission

Bitcoin

Cryptocurrency, blockchain, Satoshi

Marie Curie

Radioactivity, Nobel Prizes, legacy

CRISPR

Gene editing, Doudna, applications

OpenAI

GPT, AGI, Sam Altman, safety

Start in 60 seconds

Clone the repo, edit your subject, run one command. Research starts automatically.

Clone Autoresearch