Show HN: Sync Tool for Claude and Codex Configurations
Continuous bidirectional sync solution between two AI platforms with drift visualization.
1Bidirectional Synchronization
This tool provides continuous bidirectional sync between Claude and Codex platforms. Rather than a one-time migration, it manages configuration drift between systems. Preserves native structures of both platforms through lossless YAML round-tripping and automatic token translation.
2Safe and Controlled Operations
All sync operations are risk-tagged (safe/partial/manual). Automatic backups are created before overwrites with FIFO retention (30 backups). Users can preview changes with --dry-run before applying with --apply, ensuring controlled deployments.
3Visual Inventory Board
The tool generates an interactive HTML dashboard showing all skills, agents, and hooks across both platforms. Items are color-coded by sync status (in-sync/conflict/single-host). Users can filter by areas and agent harnesses for better visibility.
4Cross-Platform Compatibility
Claude and Codex implement similar concepts in different formats. This tool automatically resolves semantic differences (e.g., 'Read' → 'workspace-write') between platforms, eliminating manual intervention needs while preserving native meanings.
5Selector Syntax
Users can specify which areas to sync using --include and --exclude parameters. For example, syncing only specific skills or instructions is possible. This provides granular control in complex configuration environments.
6Installation and Usage
Installed via npm as a single ESM file with no external dependencies beyond Node.js built-ins. The connect command auto-registers host plugins. status shows configuration drift, while sync initiates synchronization between platforms.
7Backup and Audit
Every sync operation creates snapshots under .backups/. Each --apply operation logs item-level sha256 hashes to a ledger file, ensuring traceability and rollback capability for all configuration changes.
8Platform-Specific Handling
The tool automatically translates platform-specific operations (like Claude's 'TaskCreate' to Codex's 'spawn_agent') while maintaining functional equivalence. This ensures content works correctly on both platforms without manual fixes.
9Scope Control
Users can specify sync scope with --scope parameter (global/project/all). Global configurations and project-specific settings can be managed separately, providing flexibility in large-scale deployments.
10Integration Friendly
The tool easily integrates with existing CI/CD pipelines. JSON output support enables integration with other tools. Host plugins ensure compatibility with Claude's and Codex's native CLI tools.
11Developer Reference
The tool provides self-generated markdown reference documentation. The reference command displays this documentation, while paraphrase allows word-level customization of instructions.
12Standardizing AI Management
This tool standardizes configuration management across different AI platforms, improving developer productivity. Particularly valuable for teams using multiple platforms, it eliminates configuration drift risks and simplifies continuous integration processes.
Original article: Hacker News: Show HN — Claude ve Codex Yapılandırmalarını Senkronize Etme Aracı