https://github.com/jahwag/ctxsync
ctxsync is a Python tool that automates the synchronization of local files with Claude.ai Projects
https://github.com/jahwag/ctxsync
claude-ai llm productivity-tool python
Last synced: 19 days ago
JSON representation
ctxsync is a Python tool that automates the synchronization of local files with Claude.ai Projects
- Host: GitHub
- URL: https://github.com/jahwag/ctxsync
- Owner: jahwag
- License: mit
- Created: 2024-07-16T17:13:18.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2026-06-11T12:14:19.000Z (about 1 month ago)
- Last Synced: 2026-06-15T11:09:01.421Z (26 days ago)
- Topics: claude-ai, llm, productivity-tool, python
- Language: Python
- Homepage:
- Size: 702 KB
- Stars: 737
- Watchers: 10
- Forks: 69
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-github-projects - ctxsync - ctxsync is a Python tool that automates the synchronization of local files with Claude.ai Projects ⭐739 `Python` 🔥 (🤖 AI & Machine Learning)
- awesome - jahwag/ctxsync - ctxsync is a Python tool that automates the synchronization of local files with Claude.ai Projects (Python)
README
# ctxsync
[](https://opensource.org/licenses/MIT)
[](https://pypi.org/project/ctxsync/)
[](https://github.com/jahwag/ctxsync/releases)
[](https://github.com/jahwag/ctxsync/actions/workflows/python-package.yml)
[](https://github.com/jahwag/ctxsync/issues)
[](https://github.com/psf/black)
[](https://github.com/jahwag/ctxsync/network/dependencies)
[](https://github.com/jahwag/ctxsync/commits/main)
[](https://github.com/sponsors/jahwag)
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](https://www.anthropic.com/legal/consumer-terms) before using ctxsync.
## 🌟 Features
- **File sync**: Synchronize local files with [Claude.ai projects](https://www.anthropic.com/news/projects).
- **Cross-Platform**: Compatible with [Windows, macOS, and Linux](https://github.com/jahwag/ctxsync/releases).
- **Configurable**: Plenty of [configuration options](https://github.com/jahwag/ctxsync/wiki/Quick-reference).
- **Integrate**: Designed to be easy to integrate into your pipelines.
- **Secure**: Ensures data privacy and security.
## ⚙️ Prerequisites
### 📄 Supported Claude.ai plans
| [Plan](https://www.anthropic.com/pricing) | Supported |
|--------|-----------|
| Pro | ✅ |
| Team | ✅ |
| Free | ❌ |
### 🔑 SSH Key
Ensure you have an SSH key for secure credential storage. Follow [GitHub's guide](https://docs.github.com/en/authentication/connecting-to-github-with-ssh) to generate and add your SSH key.
### 💻 Software
- **Python**: ≥ [3.10](https://www.python.org/downloads/)
- **pip**: [Python package installer](https://pip.pypa.io/en/stable/installation/)
## 🚀 Quick Start
1. **Install ctxsync**
```shell
pip install ctxsync
```
2. **Authenticate**
```shell
ctxsync auth login
```
3. **Create a Project**
```shell
ctxsync project create
```
4. **Start Syncing***
```shell
ctxsync push
```
**This is a one-way sync. Files not present locally will be removed from the Claude.ai project unless pruning is [disabled](https://github.com/jahwag/ctxsync/wiki/Quick-reference#pruning-remote).*
📚 [Detailed Guides & FAQs](https://github.com/jahwag/ctxsync/wiki)
## 🤝 Support & Contribute
Enjoying ctxsync? Support us by:
- ⭐ [Starring the Repository](https://github.com/jahwag/ctxsync)
- 🐛 [Reporting Issues](https://github.com/jahwag/ctxsync/issues)
- 🌍 [Contributing](CONTRIBUTING.md)
- 💬 [Join Our Discord](https://discord.gg/pR4qeMH4u4)
- 💖 [Sponsor Us](https://github.com/sponsors/jahwag)
Your contributions help improve ctxsync!
---
[Contributors](https://github.com/jahwag/ctxsync/graphs/contributors) • [License](https://github.com/jahwag/ctxsync/blob/master/LICENSE) • [Report Bug](https://github.com/jahwag/ctxsync/issues) • [Request Feature](https://github.com/jahwag/ctxsync/issues/new?labels=enhancement&template=feature_request.md)• [Sponsor](https://github.com/sponsors/jahwag)