Angular AI Bootstrap

Richtet Angular-Projekte für den Codex-Agenten im JetBrains AI Chat und für JetBrains AI Assistant ein. Zusätzlich werden der offizielle Angular-CLI-MCP und Context7 für aktuelle Bibliotheksdokumentation vorbereitet.

Was installiert wird

• AGENTS.md für Codex und andere kompatible Coding Agents
• .aiassistant/rules/angular.md für den normalen JetBrains AI Chat
• .agents/skills/angular-development/SKILL.md
• .agents/skills/angular-review/SKILL.md
• .agents/skills/context7-library-docs/SKILL.md
• scripts/ai-check.mjs
• docs/PHPSTORM_MCP.md mit einer Schritt-für-Schritt-Anleitung
• npm run ai:check in package.json

Das Paket erkennt dokumentationsrelevante Dependencies aus package.json, zum Beispiel Tailwind CSS, RxJS, PrimeNG, Angular Material, NgRx, Chart-Bibliotheken und Testwerkzeuge. Diese Paketnamen und Versionen werden in die generierten Agent-Regeln übernommen.

Das Paket verändert keine internen PhpStorm-Einstellungen und speichert keine Zugangsdaten.

Schnelleinrichtung in einem Angular-Projekt

cd /vollständiger/pfad/zum/angular-projekt
npm install
npx @espresso-tutorials/angular-ai-bootstrap init
npx angular-ai-bootstrap doctor
npx angular-ai-bootstrap mcp --copy

Danach in PhpStorm:

1. Settings → Tools → AI Assistant → Model Context Protocol (MCP) öffnen.
2. Add → STDIO auswählen.
3. Den kopierten JSON-Block einfügen.
4. Das Projektverzeichnis als Working directory auswählen.
5. Server level auf Project setzen.
6. Speichern und die Server verbinden.

Die ausführliche Anleitung wird im Projekt unter docs/PHPSTORM_MCP.md erzeugt.

Wichtige Pfade schnell anzeigen

# Projektpfad
pwd

# Node-Pfad
which node

# npx-Pfad
which npx

# Projekt, Node, npx und Angular CLI gesammelt
npx angular-ai-bootstrap paths

Beispiel:

Projekt:     /Users/name/PhpstormProjects/mein-projekt
Node:        /Users/name/.nvm/versions/node/v24.15.0/bin/node
npx:         /Users/name/.nvm/versions/node/v24.15.0/bin/npx
Angular CLI: /Users/name/PhpstormProjects/mein-projekt/node_modules/@angular/cli/bin/ng.js

MCP-Server schnell testen

Angular CLI:

"$(which node)" "$(pwd)/node_modules/@angular/cli/bin/ng.js" mcp

Context7:

"$(which npx)" -y @upstash/context7-mcp@3

Beide Prozesse sollten ohne normale Ausgabe aktiv bleiben. Mit Ctrl+C beenden.

Wichtig: -y gehört zu npx, nicht zu node. Diese falsche Kombination:

node -y @upstash/context7-mcp@3

führt zu:

node: bad option: -y

Als Dev Dependency installieren

npm install --save-dev @espresso-tutorials/angular-ai-bootstrap
npx angular-ai-bootstrap init

Optional in package.json:

{
  "scripts": {
    "ai:setup": "angular-ai-bootstrap update",
    "ai:doctor": "angular-ai-bootstrap doctor",
    "ai:paths": "angular-ai-bootstrap paths",
    "ai:mcp": "angular-ai-bootstrap mcp --copy"
  }
}

Danach stehen die wichtigsten Befehle kurz zur Verfügung:

npm run ai:setup
npm run ai:doctor
npm run ai:paths
npm run ai:mcp

Bestehendes Setup aktualisieren

npx @espresso-tutorials/angular-ai-bootstrap update

Bestehende eigene Inhalte in AGENTS.md bleiben erhalten. Der vom Paket verwaltete Abschnitt wird über Marker aktualisiert.

Context7

Context7 ist standardmäßig aktiviert. Die Aufgabenverteilung lautet:

• Angular-Core, Angular CLI, Workspace, Builds und Angular-Best-Practices: Angular-CLI-MCP
• Tailwind CSS, RxJS, PrimeNG, Angular Material, NgRx und weitere Drittbibliotheken: Context7
• vorhandene Projektstruktur, Symbolsuche und Inspections: PhpStorm-Werkzeuge

Context7 deaktivieren:

npx @espresso-tutorials/angular-ai-bootstrap init --no-context7

Oder nur eine Angular-MCP-Konfiguration ausgeben:

npx angular-ai-bootstrap mcp --no-context7 --copy

Befehle

angular-ai-bootstrap init
angular-ai-bootstrap update
angular-ai-bootstrap doctor
angular-ai-bootstrap paths
angular-ai-bootstrap mcp --copy

Wichtige Optionen:

--dry-run
--force
--minimal
--no-rules
--no-skills
--no-check
--no-package-script
--no-context7
--cwd <pfad>

Häufige Fehler

node: bad option: -y

Context7 wurde mit node statt npx gestartet. Erstelle die Konfiguration neu:

npx angular-ai-bootstrap mcp --copy

connection closed: initialize response

Teste die Server einzeln:

npm install
"$(which node)" "$(pwd)/node_modules/@angular/cli/bin/ng.js" mcp
"$(which npx)" -y @upstash/context7-mcp@3

LazyStandaloneCoroutine was cancelled

Das ist meist ein Folgefehler. Prüfe die Meldung unmittelbar davor. Häufig ist ein falscher Programm- oder Projektpfad die Ursache.

Veröffentlichung

Vor der ersten Veröffentlichung den Paketnamen und das Scope prüfen:

npm login
npm publish --access public

Für ein privates Unternehmenspaket kann publishConfig.access auf restricted geändert werden.