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:

1. Use it at your own risk.
2. Acknowledge potential violation of Anthropic's Terms of Service.
3. Assume responsibility for any consequences.
4. 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

🔑 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

1. Install ctxsync

   hljs language-shell

   Copy

   pip install ctxsync
   

2. Authenticate

   hljs language-shell

   Copy

   ctxsync auth login
   

3. Create a Project

   hljs language-shell

   Copy

   ctxsync project create
   

4. Start Syncing*

   hljs language-shell

   Copy

   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:

• ⭐ Starring the Repository
• 🐛 Reporting Issues
• 🌍 Contributing
• 💬 Join Our Discord
• 💖 Sponsor Us

Your contributions help improve ctxsync!

---

Contributors • License • Report Bug • Request Feature• Sponsor