ties 0.0.0a7

A CLI tool to duplicate and sync file content with advanced transformations.

Ties 🔗

A powerful CLI tool to duplicate and sync file content with advanced transformations. Keep your repository files in sync automatically with intelligent content synchronization.

✨ Features

• File Synchronization: Automatically keep multiple files in sync across your repository
• Advanced Transformations: Apply custom transformations during file copying
• Pre-commit Integration: Enforce file consistency as part of your development workflow
• Configuration-Driven: Simple TOML-based configuration
• Environment Variable Support: Embed environment variables in target files
• Cross-Platform: Works on Windows, macOS, and Linux

🚀 Quick Start

Installation

# Install from PyPI
pip install ties

# Or install with YAML support
pip install ties[yaml]

# Or install from source
git clone https://github.com/AlonKellner/ties.git
cd ties
pip install -e .

Basic Usage

1. Create a configuration in your pyproject.toml:

[tool.ties]
[[tool.ties.tie]]
name = "gitignore sync"
source = ".gitignore"
target = "examples/.gitignore"

2. Check for discrepancies:

ties check

3. Fix discrepancies automatically:

ties fix

Advanced Configuration

[tool.ties]
[[tool.ties.tie]]
name = "Environment Config"
source = ".ties/config.template"
targets = [".env.local", ".env.production"]
transform = "ties:embed_environ"

[[tool.ties.tie]]
name = "Documentation Sync"
source = "README.md"
target = "docs/README.md"
transform = "transform:markdown_cleanup"

📖 Documentation

• User Guide - Complete usage instructions
• Examples - Common use cases and examples

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

Prerequisites

• Docker
• VSCode/Cursor (or any IDE with devcontainer support)

Steps

Either click the badge (VSCode only)

or (Cursor/VSCode)

1. git clone https://github.com/AlonKellner/ties.git
2. Open the repository in your IDE of choice
3. cmd+shift+p/ctrl+shift+p
4. Type "reopen"
5. Choose "Dev Containers: Reopen in Container"

This will automatically:

1. Build and start a devcontainer with binary requirements
2. Install the pre-commit hooks
3. Use uv to install python and all python dependencies into a local .venv
4. Install a few MCP servers

The first time it will fail and prompt you for 3 things:

• Add a github access token to ./.devcontainer/.env:

  GITHUB_PERSONAL_ACCESS_TOKEN=<your_personal_access_token_here>
  

• Generate a GPG key and add it to github

• Configure a GPG key as your signing key

MCP

The current MCP servers that this repo supports are:

1. github-mcp-server (Remote)
2. repomix (Local)
3. mcp-language-server

Claude Code

The pre-commit setup in this repo uses claude code to automatically review changes.
By default, claude will not be configured and will automatically pass in the pre-commit.

If you want to use claude to review changes, you can read about Claude Code Deployment.

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with modern Python tooling (uv, ruff, pytest)
• CI/CD powered by GitHub Actions
• Security scanning with Trivy

📊 Project Status

• Development Status: Alpha
• Python Support: 3.10+
• License: MIT
• Maintainer: Alon Kellner

---

Made with ❤️ by the Ties community