Démarrage, commandes et garde-fous pour Paradev (anciennement Superset). Voir aussi les avis sur Paradev. La CLI s’appelle toujours superset ; paradev en est un alias.

Installation

# CLI autonome : macOS ou Linux (x64, arm64)
curl -fsSL https://paradev.com/cli/install.sh | sh
 
# Alternative Homebrew
brew install paradevai/tap/superset
 
# Se connecter, puis vérifier la session
superset auth login
superset auth whoami

L’application de bureau inclut aussi la CLI dans ~/.paradev/bin. Ajouter ce dossier au PATH pour l’utiliser depuis un terminal externe : export PATH="$HOME/.paradev/bin:$PATH". En CI, utiliser une clé d’API : superset auth login --api-key … ou la variable SUPERSET_API_KEY.

Cycle minimal

# Enregistrer un dépôt local
superset projects create --name "mon-app" --local --import /chemin/mon-app
 
# Lister projets et workspaces
superset projects list
superset workspaces list --local
 
# Créer un worktree isolé
superset workspaces create \
  --project PROJECT_ID \
  --name "fix-login" \
  --branch fix/login \
  --local
 
# Créer et démarrer directement un agent
superset workspaces create \
  --project PROJECT_ID \
  --name "fix-login" \
  --branch fix/login \
  --local \
  --agent codex \
  --prompt "Corrige le bug et lance les tests ciblés"
 
# Session temporaire sans projet existant
superset workspaces create --session --local --agent claude --prompt "Explore cette idée"

Configuration d’un projet

Créer .paradev/config.json (un dépôt configuré avant le renommage garde .superset/config.json, que Paradev continue de lire) :

{
  "setup": [
    "bun install",
    "cp \"$SUPERSET_ROOT_PATH/.env\" .env"
  ],
  "teardown": ["docker compose down"],
  "run": ["./.paradev/run.sh"]
}
ÉtapeConseil
setupInstaller ou lier les dépendances et préparer les fichiers ignorés.
runAttribuer un port distinct à chaque workspace.
teardownArrêter conteneurs, watchers et ressources temporaires.
SecretsNe jamais les committer ; les copier depuis le checkout racine ou un gestionnaire.

Variables disponibles dans les scripts : SUPERSET_ROOT_PATH (checkout racine), SUPERSET_WORKSPACE_NAME, SUPERSET_WORKSPACE_PATH.

Commandes pratiques

superset workspaces list --json
superset workspaces list --quiet
superset tasks list --assignee-me
superset automations list
superset automations run AUTOMATION_ID
superset automations logs AUTOMATION_ID
superset config check

--json convient aux scripts et --quiet renvoie seulement les identifiants lorsque cela est possible. superset seul ouvre un navigateur interactif des commandes ; superset --help en donne la liste.

Choisir le bon mode

SituationMode conseillé
Deux fonctionnalités indépendantesDeux worktrees et deux branches.
Implémentation puis revue du même diffMême workspace, sessions distinctes.
Exploration jetableSession sans projet (--session).
Petite correction dans le checkout courant--checkout local, avec prudence.
Agents modifiant les mêmes fichiersSéquentiel, ou branches puis fusion explicite.

Routine de livraison

  1. Lire le diff et les fichiers non suivis.
  2. Exécuter tests, lint et build dans le workspace.
  3. Envoyer les commentaires de revue à un agent distinct.
  4. Commit et push seulement après validation.
  5. Créer la PR, vérifier la CI, puis fusionner.
  6. Archiver le workspace et exécuter le teardown.

Sources