Agent Dotfiles

agent-dotfiles

Write AI coding rules once, sync to every agent.

Most developers already have an AGENTS.md or CLAUDE.md in their projects. agent-dotfiles reads your existing rules and propagates them to every coding agent you use. No new directories, no config files, no lock-in.

Supported Agents

Install

Usage

Detect & Status

Run without arguments to see detected agents, found rules, and available commands:

Sync Rules

Sync your rules file to all agents:

Sync to specific agents:

Sync Skills

Global Rules

Sync global rules across agents:

Dry Run

Preview what would happen without writing files:

Options

Strategies

- skip (default) — never overwrites existing files
- overwrite — replaces existing files with source content
- merge — appends source content to existing files

Config

Optional config at ~/.agents/agent-dotfiles.json:

How It Works

agent-dotfiles is a propagator, not a creator. It reads your existing rules files and syncs them to agent-specific locations. Smart enough to skip agents that already natively read your source file.

For example, syncing from AGENTS.md:
- Skips Command Code, Cursor, Codex, OpenCode (they already read AGENTS.md)
- Creates CLAUDE.md for Claude Code (it only reads CLAUDE.md)

Contributing

We welcome contributions — especially adding support for new coding agents! Check out the Contributing Guide for a step-by-step walkthrough.

License

MIT

Built by Saqib with Command Code