Prerequisites

What you need before installing Claudear

Prerequisites

Before installing Claudear, ensure you have the following set up on your system.

Required Software

Python 3.9+

Claudear requires Python 3.9 or higher.

python3 --version
# Should output: Python 3.9.x or higher

Installation:

• macOS: brew install python@3.12
• Ubuntu: sudo apt install python3.12
• Windows: Download from python.org

Claude Code CLI

Claudear uses Claude Code to implement tasks. You need:

1. Claude Code CLI installed
2. Active Claude subscription (Pro or Team)
3. Authenticated session

Install:

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

Authenticate:

claude auth login

Verify:

claude whoami

GitHub CLI

For PR creation, Claudear uses the GitHub CLI.

Install:

# macOS
brew install gh

# Ubuntu
sudo apt install gh

# Windows
winget install GitHub.cli

Authenticate:

gh auth login

Verify:

gh auth status

Git

Git 2.20+ with worktree support.

git --version
# Should output: git version 2.20.0 or higher

Service Accounts

Linear API Key (if using Linear)

1. Go to Linear Settings → API
2. Click "Create new API key"
3. Name it "Claudear"
4. Copy the key (starts with lin_api_)

Permissions needed:

• Read/write issues
• Read/write comments
• Read workflow states

Notion Integration (if using Notion)

1. Go to Notion Integrations
2. Click "New integration"
3. Name it "Claudear"
4. Select your workspace
5. Copy the Internal Integration Token (starts with secret_)

After creating the integration:

• Open your Notion database
• Click "..." → "Add connections"
• Select your Claudear integration

ngrok Account (if using Linear)

ngrok provides a public URL for your local webhook server. Only required for Linear.

1. Sign up at ngrok.com
2. Go to Your Authtoken
3. Copy your auth token

Free tier is sufficient for personal use.

GitHub Token

Required for PR creation:

1. Go to GitHub Settings → Developer settings → Personal access tokens
2. Create a token with repo scope
3. Copy the token (starts with ghp_)

Repository Requirements

Your target repository should:

• Be a git repository
• Have a main or master branch
• Be accessible to Claude Code
• Have CI/CD set up (optional but recommended)

Recommended Repository Setup

# Ensure remote is configured
git remote -v

# Ensure main branch exists
git branch -a | grep main

# Ensure clean working tree
git status

System Requirements

Each concurrent task uses a separate worktree, so disk space scales with MAX_CONCURRENT_TASKS.

Network Requirements

• Outbound HTTPS to:

  • api.linear.app (if using Linear)
  • api.notion.com (if using Notion)
  • api.anthropic.com
  • api.github.com
  • ngrok.io (if using Linear)

• Inbound HTTPS via ngrok tunnel (Linear only)

Quick Checklist

# Run these commands to verify your setup

# Python
python3 --version

# Claude Code
claude --version
claude whoami

# GitHub CLI
gh --version
gh auth status

# Git
git --version

# ngrok (only for Linear)
ngrok --version

All commands should succeed without errors before proceeding to Quick Start.