ctxsync is a Python tool that automates the synchronization of local files with Claude.ai Projects.

ctxsync

ctxsync (formerly known as ClaudeSync) bridges your local development environment with Claude.ai projects, enabling seamless synchronization to enhance your AI-powered workflow.

Renamed from ClaudeSync: the claudesync PyPI package is deprecated — install ctxsync instead. Your existing configuration is picked up automatically: ~/.claudesync is migrated on first run and project-local .claudesync directories keep working.

⚠️ Disclaimer

ctxsync is an independent, open-source project not affiliated with Anthropic or Claude.ai. By using ctxsync, you agree to:

Use it at your own risk.
Acknowledge potential violation of Anthropic's Terms of Service.
Assume responsibility for any consequences.
Understand that Anthropic does not support this tool.

Please review Anthropic's Terms of Service before using ctxsync.

🌟 Features

File sync: Synchronize local files with Claude.ai projects.
Cross-Platform: Compatible with Windows, macOS, and Linux.
Configurable: Plenty of configuration options.
Integrate: Designed to be easy to integrate into your pipelines.
Secure: Ensures data privacy and security.

⚙️ Prerequisites

📄 Supported Claude.ai plans

Plan	Supported
Pro	✅
Team	✅
Free	❌

🔑 SSH Key

Ensure you have an SSH key for secure credential storage. Follow GitHub's guide to generate and add your SSH key.

💻 Software

Python: ≥ 3.10
pip: Python package installer

🚀 Quick Start

Install ctxsync
```
pip install ctxsync
```
Authenticate
```
ctxsync auth login
```
Create a Project
```
ctxsync project create
```
Start Syncing*
```
ctxsync push
```
*This is a one-way sync. Files not present locally will be removed from the Claude.ai project unless pruning is disabled.

📚 Detailed Guides & FAQs

🤝 Support & Contribute

Enjoying ctxsync? Support us by:

Your contributions help improve ctxsync!

Contributors • License • Report Bug • Request Feature• Sponsor