# Show HN: Sync Tool for Claude and Codex Configurations

Continuous bidirectional sync solution between two AI platforms with drift visualization.

- **Source:** [Hacker News: Show HN](https://news.ycombinator.com)
- **Published:** 2026-07-25
- **Topic:** [Data & AI](https://brifing.si/c/data-ai)
- **Original article:** <https://github.com/slash9494/ai-config-sync-manager>
- **On Brifing:** https://brifing.si/s/6a5e528b-0ada-49db-bbe5-678c915fd8b2

## Bidirectional 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.

## Safe 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.

## Visual 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.

## Cross-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.

## Selector 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.

## Installation 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.

## Backup 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.

## Platform-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.

## Scope 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.

## Integration 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.

## Developer Reference

The tool provides self-generated markdown reference documentation. The reference command displays this documentation, while paraphrase allows word-level customization of instructions.

## Standardizing 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.

## Sources covering this story

- https://github.com/slash9494/ai-config-sync-manager — 

---

_Summary written by Brifing from the original reporting. Copyright in the original article belongs to its publisher; read the full piece at the link above._