Practical overview
When it fits
Use Ctxsync when you want to manage Claude.ai Project files from a local directory through a Python CLI, while accounting for its one-way push behavior.
Who it is for
- Developers who maintain Claude.ai Project context from local files.
- Teams or individuals seeking a command-line file-push step in a development pipeline.
Documented uses
- Send local project files to a Claude.ai Project.
- Create a repeatable local-to-Claude.ai file-push workflow.
- Add project file synchronization to a development pipeline.
Requirements & limits
Requires Python 3.10 or later, pip, an SSH key and a Claude.ai Pro or Team plan. The README lists the Free plan as unsupported. The project is MIT-licensed.
- The documented push direction is local to Claude.ai, not bidirectional.
- By default, remote files absent from the local directory are removed; pruning can be disabled.
- The project states it is independent of Anthropic and advises reviewing Anthropic’s terms of service.
- The README identifies Windows, macOS and Linux as supported platforms.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up a local-to-Claude.ai project push
Install Ctxsync, authenticate, create a Claude.ai Project and push local files.
Before you start
- Python 3.10 or later and pip
- An SSH key for credential storage
- A Claude.ai Pro or Team plan
Steps
Install with the command below.
pip install ctxsyncAuthenticate with
ctxsync auth login.Create a project with
ctxsync project create.Push local files with
ctxsync push.
Expected outcome
Local files are pushed to a Claude.ai Project.
Guide limitations
- Push is one-way, not bidirectional synchronization.
- Files missing locally are removed from the Claude.ai Project unless pruning is disabled.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 7 November 2026
- Original website title
- jahwag/ctxsync · Official homepage title · retained in its source language

