agents-927

Duplicate a canonical instructions file into agent-specific filenames (AGENTS.md, CLAUDE.md, etc.).

Installation

npm install -g agents-927

Usage

Basic Usage

# Use default source (agent-main.md) with targets from file header
agents-927

# Specify source and targets via flags
agents-927 --source my-prompt.md --targets AGENTS.md CLAUDE.md CHATGPT.md

# Use positional arguments
agents-927 my-prompt.md AGENTS.md CLAUDE.md CHATGPT.md

Target Configuration in Source File

Add a targets header to your source file to specify default targets:

<!-- targets: AGENTS.md, CLAUDE.md, CHATGPT.md, GEMINI.md -->

# Your Agent Instructions

Your prompt content here...

Alternative header format:

# targets: AGENTS.md, CLAUDE.md, CHATGPT.md, GEMINI.md

# Your Agent Instructions

Your prompt content here...

Options

• --source, -s <file>: Source file (overrides positional argument)
• --targets, -t <files...>: Target files (overrides positional arguments and file header)
• --mode, -m <copy|hard|sym>: Operation type (default: copy)
  • copy: Copy files (default)
  • hard: Create hard links
  • sym: Create symbolic links

Examples

# Copy agent-main.md to multiple agent files
agents-927

# Use symbolic links instead of copying
agents-927 --mode sym

# Specify custom source and targets
agents-927 --source custom-prompt.md --targets CUSTOM1.md CUSTOM2.md

# Mix flags and positional arguments
agents-927 --source my-prompt.md TARGET1.md TARGET2.md

Priority Order

The tool determines source and targets in this priority order:

1. Command line flags (highest priority)
2. Positional arguments
3. File header configuration (lowest priority)

License

MIT

Name

xkcd 927