Introduction
Autonomous development automation with Claude Code and Notion
Introduction
Clotion is an open-source autonomous development automation tool that bridges Notion project management with Claude Code. When you move a Notion card to "Todo", Clotion automatically picks it up, creates an isolated git worktree, runs Claude Code to implement the task, and manages the full lifecycle through PR creation.
How It Works
- Move a card to Todo in Notion
- Clotion's poller detects the change
- A dedicated git worktree and branch are created
- Claude Code analyzes the task and implements the solution
- If blocked, Claude sets the Blocked checkbox and waits for your comment
- When complete, a PR is created and the card moves to "In Review"
- Move to "Done" to auto-merge the PR
Key Features
- Notion Integration - Polls your database for changes, no webhooks needed
- Git Worktrees - Isolated environments for parallel task execution
- Claude Code CLI - Uses your existing Claude Code subscription
- Human in the Loop - Claude sets Blocked when stuck, comment to continue
- PR Automation - Creates PRs with proper titles and Notion card links
- Crash Recovery - SQLite persistence survives restarts
Why Clotion?
- Open Source - MIT licensed, fork and modify freely
- No Ngrok Required - Uses polling instead of webhooks
- No API Costs - Uses Claude Code subscription, not API credits
- Full Control - Configure states, concurrency, timeouts
Notion Properties
Clotion uses these properties on your Notion database (auto-created on first run):
| Property | Type | Description |
|---|---|---|
| Status | Select | Kanban column (Backlog, Todo, In Progress, etc.) |
| Blocked | Checkbox | Red indicator when Claude needs help |
| Current Status | Text | Real-time activity ("Reading files...", "Running tests...") |
| Clotion ID | Text | Unique identifier (CLO-001, CLO-002, etc.) |
| Branch | Text | Git branch name |
| PR URL | URL | Link to the GitHub PR |
Prerequisites
Before you begin, ensure you have:
- Python 3.10 or higher
- Claude Code CLI installed and authenticated
- GitHub CLI (
gh) installed and authenticated - A Notion workspace with a database for tasks
- A Notion integration with access to your database
Ready to get started? Head to the Quick Start guide.