ai-ide-config

Scaffold shared Cursor IDE / agent setup into a project: shared .cursor rules/commands, plus stack-specific AGENTS.md and stack rules when needed.

Install / run

npx ai-ide-config init

Usage

# Interactive: pick a stack
npx ai-ide-config init

# Non-interactive
npx ai-ide-config init --stack angular
npx ai-ide-config init-angular

# Options
npx ai-ide-config init --force        # overwrite existing files
npx ai-ide-config init --dry-run      # preview only
npx ai-ide-config init --skip-skills  # skip midudev/autoskills install
npx ai-ide-config init ./apps/web     # target directory

Existing template files are skipped unless you pass --force.

.gitignore is handled specially:

• If missing → create it with .cursor/ and .agents/
• If present → append .cursor/ and/or .agents/ only when missing

If package.json exists, init pins an exact packageManager / devEngines.packageManager to the installed pnpm version.

After scaffolding, the CLI runs pnpx skills add midudev/autoskills (use --skip-skills to skip; on --dry-run it is only printed).

In CI or non-TTY shells, pass --stack (or use init-<stack>). Interactive prompts require a terminal.

What gets written

| Path | Source | |------|--------| | .cursor/rules/conventional-commits.mdc | shared | | .cursor/commands/generate-pr-description.md | shared | | .cursor/rules/angular-20.mdc | angular (angular.dev) | | AGENTS.md | angular | | pnpm-workspace.yaml | angular (blockExoticSubdeps, minimumReleaseAge: 4320) | | .gitignore | create or append .cursor/ and .agents/ |

After init, edit AGENTS.md placeholders (<PROJECT_NAME>, <VERSION>, domains, paths) for the target repo.

Stacks

| Id | Label | |----|-------| | angular | Angular |

License

MIT