rail

AI coding workflow installer for Claude Code.

rail sync overlays a Claude Code workflow (proposal → spec → coder → review → docs) onto an existing project. The workflow is framework-agnostic — it adapts to whatever test tooling the project already uses.

Install & run

npx rail sync

Or pin the version:

npx rail@latest sync

Options

rail sync [options]

  --force              overwrite existing files and package.json entries
  --no-install         skip dependency install
  --pm <name>          package manager (pnpm | npm | yarn | bun, default: pnpm)
  --cwd <path>         target project root (default: process.cwd())

What it installs

Files copied into the target project:

• .claude/skills/{rail-proposal,rail-spec,rail-coder,rail-review,rail-docs}/SKILL.md
• .claude/agents/{rail-proposal,rail-spec,rail-coder,rail-review,rail-docs}.md
• .rail/changes/ and .rail/docs/

package.json is updated with:

• scripts: rail:sync

Existing entries are kept untouched unless --force is passed.

Idempotency

Running rail sync twice is safe: every conflicting file or package.json key is reported as skipped. Use --force to opt into an overwrite.

Requirements

• Node ≥ 18

License

MIT