Prerequisites

What you need before installing Clotion

Prerequisites

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

Required Software

Python 3.10+

Clotion requires Python 3.10 or higher.

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

Installation:

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

Claude Code CLI

Clotion 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, Clotion 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

Notion Setup

Create a Notion Integration

1. Go to notion.so/my-integrations
2. Click + New integration
3. Name it "Clotion"
4. Select your workspace
5. Under Capabilities, enable:
   • Read content
   • Update content
   • Insert content
6. Click Submit
7. Copy the Internal Integration Token (starts with secret_)

Prepare Your Database

You need a Notion database for tasks. It must have:

1. A Status property (select type)
2. These status options:
   • Backlog
   • Todo
   • In Progress
   • In Review
   • Done

Or configure Clotion to use your existing status names.

Share Database with Integration

1. Open your database in Notion
2. Click ... → Add connections
3. Select your "Clotion" integration

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.notion.com
  • api.anthropic.com
  • api.github.com

No inbound connections required (unlike webhook-based solutions).

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

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

What You Don't Need

Unlike webhook-based solutions, Clotion does not require:

• ngrok or other tunneling services
• Public IP or domain
• Port forwarding
• Webhook endpoints

This makes setup simpler and works behind firewalls.