Autonomous Development withClaude+Notion

Hand off Notion tasks to Claude Code. Clotion implements, tests, creates PRs, and manages the full lifecycle. Let Claude Code do the coding while you focus on what matters.

Clotion
# 1. Clone the repository$ git clone https://github.com/ianborders/clotion.git$ cd clotion# 2. Install the clotion command$ pip install clotion
// HOW_IT_WORKS

From Notion Card to Merged PR

Clotion automates the entire development workflow, from picking up tasks to creating pull requests.

01
Trigger

Move card to Todo

Drag a Notion card from Backlog to Todo. Clotion's poller picks it up automatically.

02
Isolation

Create worktree

A dedicated git worktree and branch are created, isolating work from your main codebase.

03
Implementation

Claude implements

Claude Code analyzes the issue, explores the codebase, and implements the solution.

04
Blocked

Human in the loop

If Claude gets stuck, it sets the Blocked checkbox. Add a comment to unblock.

05
Review

PR created

When complete, code is pushed and a PR is created. Issue moves to In Review.

06
Complete

Auto-merge

Move the issue to Done and the PR auto-merges. Worktree cleaned up automatically.

// FEATURES

Built for Real Workflows

Notion Integration

Polls your Notion database for changes. No webhooks or ngrok required.

Git Worktrees

Each task gets an isolated worktree. Run multiple tasks in parallel without conflicts.

Claude Code CLI

Uses your Claude Code subscription, not API credits. Same Claude, just automated.

PR Automation

PRs created via GitHub CLI with proper titles, descriptions, and Notion card links.

Human in Loop

When blocked, Claude sets the Blocked checkbox. Comment on the card to continue.

Crash Recovery

SQLite persistence means tasks survive restarts. Pick up where you left off.

// WHY_CLOTION

Open Source. Self-Hosted. Yours.

Open Source

MIT licensed. Fork it, modify it, contribute back. Built in public for the community.

Uses Your Subscription

Runs Claude Code CLI in headless mode. No separate API costs - uses your existing Claude Code subscription.

No Ngrok Required

Uses polling instead of webhooks. Just run it locally - no tunnel setup needed.

Full Control

You own the workflow. Configure states, concurrency limits, timeouts - everything is customizable.

// GET_STARTED

Ready to automate your development?

Get started in minutes. Install Clotion, connect your Notion database, and let Claude Code handle the implementation.

1. Install
2. Configure
3. Move to Todo
4. Watch it work
MIT Licensed • Uses your Claude Code subscription