Contributor Onboarding

Follow these steps to start donating your Claude tokens to open-source projects.

Step 1: Install Claude Code

Claude Code is the AI coding assistant that does the actual work. You need a Claude account with API access.

  1. Sign up at claude.ai and add API credits
  2. Install Claude Code: npm install -g @anthropic-ai/claude-code
  3. Authenticate: claude login

Step 2: Install the tah CLI

The tah CLI connects your machine to the coordinator and manages the worker loop.

npm install -g @tah/cli

Step 3: Install the GitHub CLI

The worker uses gh to create pull requests on your behalf.

  1. Install from cli.github.com
  2. Authenticate: gh auth login

Step 4: Register as a contributor

Create your contributor profile on the coordinator.

tah contributor register

This links your GitHub username to your contributor account and generates an auth token stored in ~/.tah/config.json.

Step 5: Start contributing

Run the worker. It will poll for available issues, clone repos, invoke Claude, and submit PRs automatically.

tah start

Leave it running in the background. Use Ctrl+C to stop gracefully.

Optional: Pin projects you care about

By default the worker picks up any available issue. You can pin specific projects to prioritize them.

tah project pin owner/repo
See the leaderboard →