---
applies_to: all-agents
name: add-project
description: Neues Projekt im aktuellen Workspace verknüpfen — nur Projekt-ID in project.json schreiben
---

# /add-project — Projekt verknüpfen

Verknüpft ein neues Board-Projekt mit dem lokalen Projekt. Schreibt nur `workspace_id` + `project_id` in `project.json`. Kein API Key nötig — der Workspace muss bereits verbunden sein.

## Argumente

| Flag | Beschreibung | Pflicht |
|---|---|---|
| `--project` | Projekt UUID vom Board | Ja |

## Ausführung

1. Prüfe ob ein Workspace konfiguriert ist:
   - Lies `project.json` → `pipeline.workspace_id` (primär)
   - Falls nicht vorhanden: Lies `.env.local` → `JSP_WORKSPACE_ID` (fallback)
   - Legacy-Fallback: `~/.just-ship/config.json` → `default_workspace` (nur wenn vorhandene Alt-Installation)
   - Falls alle fehlen: Fehler: "Kein Workspace konfiguriert. Führe zuerst 'just-ship connect' im Terminal aus."

2. Schreibe Projekt-Referenz:
   ```bash
   ".claude/scripts/write-config.sh" set-project \
     --workspace-id <workspace_id> --project-id <project>
   ```

3. Bestätigung:
   ```
   ✓ Projekt '<project-id>' verknüpft mit Workspace '<workspace_id>'
   ✓ project.json aktualisiert
   ```