agent-dotfiles

<p align="center">
  <img src=".github/cover.svg" alt="agent-dotfiles" />
</p>

# 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

| Agent | Rules | Skills | Detection |
|-------|-------|--------|-----------|
| Command Code | `AGENTS.md` | `.commandcode/skills/` | `~/.commandcode` |
| Claude Code | `CLAUDE.md` | `.cursor/skills/` | `~/.cursor` |
| Cursor | `AGENTS.md` | `.cursor/skills/` | `~/.cursor` |
| Cursor | `AGENTS.md` | `.github/skills/` | `~/.cursor` |
| Codex | `AGENTS.md` | `.agents/skills/` | `~/.codex` |
| OpenCode | `AGENTS.md` | `.opencode/skills/` | `~/.config/opencode` |

## Install

```sh
npx agent-dotfiles
```

## Usage

### Detect & Status

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

```sh
npx agent-dotfiles
```

### Sync Rules

Sync your rules file to all agents:

```sh
npx agent-dotfiles sync rules --from AGENTS.md --to all
```

Sync to specific agents:

```sh
npx agent-dotfiles sync rules --from AGENTS.md --to cursor,cursor
```

### Sync Skills

```sh
npx agent-dotfiles sync skills --from .cursor/skills --to all
```

### Global Rules

Sync global rules across agents:

```sh
npx agent-dotfiles sync rules --from ~/.cursor/CLAUDE.md --to all --global
```

### Dry Run

Preview what would happen without writing files:

```sh
npx agent-dotfiles sync rules --from AGENTS.md --to all --dry-run
```

## Options

| Flag | Description | Default |
|------|-------------|---------|
| `--from <source>` | Source rules file or skills directory | required |
| `--to <agents>` | Target agents (comma-separated or `all`) | `all` |
| `--strategy <s>` | `skip`, `overwrite`, or `merge` | `skip` |
| `--method <m>` | `copy` or `symlink` | `copy` |
| `--global` | Sync global