@dalzoubi/dev-agents-sync

CLI for syncing managed dev-agent prompts from dalzoubi/dev-agents into consumer repositories for Claude Code and Cursor.

Install

Run with npx from the root of the repo that should receive the agent files:

npx --yes @dalzoubi/dev-agents-sync@1 init --targets claude,cursor

The CLI requires Node.js 20 or newer.

Authentication

The source repository is private, so the CLI needs a GitHub token that can read dalzoubi/dev-agents.

Authentication is resolved in this order:

1. --token <token>
2. GITHUB_TOKEN
3. gh auth token

For local use, authenticate with the GitHub CLI:

gh auth login

For CI, set GITHUB_TOKEN or a repo secret such as DEV_AGENTS_TOKEN.

Quick Start

Initialize a consumer repo:

npx --yes @dalzoubi/dev-agents-sync@1 init --targets claude

This writes managed files into .claude/ and creates .dev-agents-sync.json with the resolved content version. Use --targets cursor or --targets claude,cursor to install Cursor project agents, rules, and slash commands into .cursor/agents/, .cursor/rules/, and .cursor/commands/.

Update to the latest matching content version:

npx --yes @dalzoubi/dev-agents-sync@1 update

Check whether managed files are in sync:

npx --yes @dalzoubi/dev-agents-sync@1 check

Show the expected diff without writing files:

npx --yes @dalzoubi/dev-agents-sync@1 diff

Show lockfile status:

npx --yes @dalzoubi/dev-agents-sync@1 status

Common Flags

• --targets claude,cursor selects output targets. Use claude, cursor, or both.
• --range ^1 selects the content version range. The default is ^1.
• --dry-run prints the planned changes without writing files.
• --force allows overwriting unmanaged file collisions.
• --token <token> passes a GitHub token directly.

Safety

Managed files include a marker:

<!-- managed-by: dev-agents-sync vX.Y.Z -->

The CLI overwrites files with this marker. It refuses to overwrite unmarked files unless --force is provided.

License

UNLICENSED. This package is proprietary and all rights are reserved.