Ai Flow Setup

ai-flow-setup

Pull your Claude Code AI-flow — global `CLAUDE.md`, rules, skills, and commands — into any machine or project, without a manual copy-paste ritual and without clobbering work you already have in place.

# Browse the catalog interactively
npx github:letStayFoolish/ai-flow-setup

# Or install specific skills/rules/docs directly by name — no prompts
npx github:letStayFoolish/ai-flow-setup grilling code-review

What it does

1. No args → lets you pick which rules, skills, and docs to pull from an interactive multiselect, grouped by scope (global → ~/.claude/..., project → ./...) and type.
2. Args given → installs exactly those catalog entries by name, no prompts. A name is either a skill's name (grilling), a rule/doc's filename without extension (clean-code), or — if that's ambiguous across scopes — the entry's full id as reported in the error (e.g. global:CLAUDE.md).
3. Never silently overwrites. For any destination file that already exists and differs from the incoming version, it shows a unified diff and asks:
   • Keep existing — do nothing
   • Overwrite — replace with the incoming version
   • Merge — append only the incoming lines missing from the existing file
   • Skip — leave it for later

Files that don't exist yet are created directly; files that are byte-identical are left alone and reported as unchanged.

Global skills install by copying into `~/.claude/skills` by default. Pass `--mode symlink-global` (symlink to a centrally-updatable copy) or `--mode project-local` (install into `./.claude/skills` instead) to change that.

Example

$ npx github:letStayFoolish/ai-flow-setup grilling
┌  ai-flow-setup
│
●  Global setup found at /Users/you/.claude
│
◆  created /Users/you/.claude/skills/grilling/SKILL.md
│
└  Done.

Learn the flow

[`docs/ai-coding-guide.pdf`](./docs/ai-coding-guide.pdf) walks through the 7-step AI-coding flow these skills and rules a