@dezkareid/ai-context-sync
v1.1.0
Published
CLI utility to synchronize AI agent context files from AGENTS.md
Maintainers
Readme
@dezkareid/ai-context-sync
A CLI utility to synchronize AI agent context files across different providers, using AGENTS.md as the source of truth.
Features
- Source of Truth: Uses
AGENTS.mdto define project context, rules, and workflows. - Multi-provider support:
- Claude: Generates/updates
CLAUDE.md. - Gemini: Configures
.gemini/settings.jsonto useAGENTS.md. - Gemini Markdown: Generates/updates
GEMINI.md.
- Claude: Generates/updates
- Plugin Architecture: Easily extendable to support other AI agents.
Installation
pnpm install @dezkareid/ai-context-syncUsage
Synchronize context
Run the sync command in your project root (where AGENTS.md is located):
npx @dezkareid/ai-context-sync syncYou can select the strategy using the --strategy (or -s) option:
npx @dezkareid/ai-context-sync sync --strategy claude
npx @dezkareid/ai-context-sync sync --strategy gemini
npx @dezkareid/ai-context-sync sync --strategy all
npx @dezkareid/ai-context-sync sync --strategy "claude, gemini"If no strategy is provided, an interactive checkbox menu will appear to let you toggle which strategies to run.
Configuration
The tool can save your selected strategies in a .ai-context-configrc file in the project root. This avoids being prompted every time you run the command.
To bypass reading or creating this configuration file, use the --skip-config flag:
npx @dezkareid/ai-context-sync sync --skip-configDirectory option
How it works
- The tool looks for an
AGENTS.mdfile in the target directory. - It reads the content of
AGENTS.md. - It applies different strategies to update provider-specific files:
- Claude: Creates a symbolic link
CLAUDE.mdpointing toAGENTS.md. - Gemini: Updates
.gemini/settings.jsonto includeAGENTS.mdin thecontext.fileNamelist.
- Claude: Creates a symbolic link
License
ISC
