Démarrage, commandes et garde-fous pour Paradev (anciennement Superset). Voir aussi les avis sur Paradev. La CLI s’appelle toujours
superset;paradeven 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 whoamiL’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"]
}| Étape | Conseil |
|---|---|
setup | Installer ou lier les dépendances et préparer les fichiers ignorés. |
run | Attribuer un port distinct à chaque workspace. |
teardown | Arrêter conteneurs, watchers et ressources temporaires. |
| Secrets | Ne 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
| Situation | Mode conseillé |
|---|---|
| Deux fonctionnalités indépendantes | Deux worktrees et deux branches. |
| Implémentation puis revue du même diff | Même workspace, sessions distinctes. |
| Exploration jetable | Session sans projet (--session). |
| Petite correction dans le checkout courant | --checkout local, avec prudence. |
| Agents modifiant les mêmes fichiers | Séquentiel, ou branches puis fusion explicite. |
Routine de livraison
- Lire le diff et les fichiers non suivis.
- Exécuter tests, lint et build dans le workspace.
- Envoyer les commentaires de revue à un agent distinct.
- Commit et push seulement après validation.
- Créer la PR, vérifier la CI, puis fusionner.
- Archiver le workspace et exécuter le teardown.