CLI

CLI

Interface en ligne de commande pour automatiser vos workflows

Vue d'ensemble

Le CLI pilote vos projets depuis le terminal, avec le même compte que l'app. Trois commandes suffisent pour le premier run.

Pour démarrer

bash
beemmvision auth login

Ouvre le navigateur, même compte que l’app

bash
beemmvision auth whoami

Vérifie que la session est là

bash
beemmvision workflow run --workflow-id default

Lance le graphe du projet courant

Commande : beemmvision. Alias visionboard. Installation et le reste des commandes sont plus bas sur cette page.

Agent-native

Conçu pour les agents IA et l'automatisation

Auth navigateur

Connexion dans le navigateur, comme sur l’app

26 nœuds

Catalogue documenté, aligné sur l'éditeur de workflow

Agent Vision

Le CLI peut demander à l’Agent de poser un graphe

Installation

Le CLI n’est pas publié sur npm. Vous l’installez depuis le dépôt GitHub, une fois, puis vous le mettez à jour avec git pull.

macOS / Linux

bash
git clone https://github.com/beemm-vision/beemmvision-cli.git && cd beemmvision-cli && chmod +x setup.sh && ./setup.sh

Clone, installe les dépendances et rend la commande beemmvision disponible

Si l’installation échoue avec EACCES, donnez à npm un dossier dans votre home, puis ajoutez-le au PATH :

bash
npm config set prefix '~/.npm-global'

Dossier npm global dans votre home

Ajoutez export PATH="$HOME/.npm-global/bin:$PATH" dans ~/.zshrc ou ~/.bashrc, rouvrez le terminal, puis relancez ./setup.sh.

Windows

Le script setup.sh s’exécute dans Git Bash ou WSL. En PowerShell :

powershell
git clone https://github.com/beemm-vision/beemmvision-cli.git
cd beemmvision-cli
npm config set prefix "$env:USERPROFILE\npm-global"
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\npm-global"
npm install
npm link --force
[Environment]::SetEnvironmentVariable("Path", "$env:USERPROFILE\npm-global;$env:Path", "User")

PowerShell : clone, installation, PATH utilisateur

Fermez et rouvrez le terminal, puis exécutez beemmvision --help.

Mettre à jour

bash
cd beemmvision-cli && git pull && npm install && npm link --force

Récupère la dernière version

Vérification

bash
beemmvision --help

Affiche toutes les commandes disponibles

Authentification

Connectez-vous avec le même compte que sur l’application. Le navigateur s’ouvre, vous validez, et le CLI mémorise la session.

Se connecter

bash
beemmvision auth login

Ouvre le navigateur pour la connexion

Vérifier la connexion

bash
beemmvision auth whoami

Affiche le compte actuellement connecté

Session expirée

La session dure environ une heure. Si une commande refuse l’accès, relancez beemmvision auth login, ou beemmvision auth refresh pour prolonger sans rouvrir le navigateur.

bash
beemmvision auth refresh

Prolonge la session en cours

Se déconnecter

bash
beemmvision auth logout

Oublie la session enregistrée sur cette machine

Configuration cloud

Par défaut, le CLI pointe déjà vers l’application : https://app.beemmvision.com. Vous n’avez rien à régler pour un usage normal.

Vérifier

bash
beemmvision config show

Affiche l’URL de l’app et le projet courant

Corriger l’URL de l’app

Utile seulement si la connexion ouvre un mauvais site.

bash
beemmvision config set --app-base-url "https://app.beemmvision.com"

Force l’URL de l’application

Réinitialiser

bash
beemmvision config clear

Efface la configuration locale (pas votre compte)

Gestion des projets

Lister les projets

bash
beemmvision project list --type workflow

Liste tous les projets workflow accessibles

Utilisez --type board pour les boards.

Créer un projet

bash
beemmvision project create --name "Mon pipeline"

Crée un projet et le définit comme courant par défaut

Utilisez --no-set-as-current pour ne pas enregistrer ce projet comme contexte par défaut.

Sélectionner le projet courant

bash
beemmvision project use --project-id YOUR_PROJECT_ID

Stocke le projet pour les prochaines commandes

Une fois défini, --project-id devient optionnel sur toutes les commandes workflow.

Vérifier / effacer

bash
beemmvision project current

Affiche le projet courant

bash
beemmvision project clear

Supprime le projet courant

Import / Export

Exporter un workflow

bash
beemmvision workflow export --workflow-id default > mon-workflow.json

Exporte le workflow en JSON portable

Le fichier JSON contient tous les noeuds, arêtes et métadonnées. Il est portable entre projets et comptes.

Importer (nouveau workflow par défaut)

bash
beemmvision workflow import --input mon-workflow.json

Crée un nouveau workflow avec un ID unique

⚠️ Par défaut, un nouveau workflow est créé. Jamais d'écrasement silencieux.

Importer dans un workflow existant

bash
beemmvision workflow import --workflow-id default --input mon-workflow.json

⚠️ Remplace le contenu du workflow cible

Un avertissement s'affiche. Utilisez --force pour le skipper.

Ajouter à côté (sans écraser)

bash
beemmvision workflow import --workflow-id default --input mon-workflow.json --mode append

Ajoute les nœuds à côté de ceux déjà présents

Les nœuds sont placés à côté du graphe existant. Les identifiants sont régénérés pour éviter les collisions. --mode replace (défaut) remplace tout le contenu du workflow cible.

Dupliquer un workflow

bash
beemmvision workflow duplicate --workflow-id default

Crée une copie nommée "Original (Copy)"

bash
beemmvision workflow duplicate --workflow-id default --name "Ma V2"

Duplique avec un nom personnalisé

Lister, renommer, surveiller

Lister les workflows du projet

bash
beemmvision workflow list

Avec projet courant

bash
beemmvision --json workflow list

Sortie JSON (scripting)

Ajoutez --project-id si aucun projet courant n'est défini.

Renommer un workflow

bash
beemmvision workflow rename --workflow-id default --name "Production v2"

Change le nom affiché dans l'app

Surveiller les changements (polling)

bash
beemmvision workflow watch --workflow-id default

Rafraîchit l'état toutes les 5 s (défaut)

bash
beemmvision workflow watch --workflow-id default --interval 10

Intervalle personnalisé en secondes (max 60)

Affiche l'URL du workflow dans l'app et les différences (nœuds, arêtes, exécution). Ctrl+C pour quitter.

Exécution de workflows

Exécutez un workflow côté backend et récupérez les résultats (images, textes, vidéos). Le CLI affiche une progression en temps réel.

Exécuter un workflow

bash
beemmvision workflow run --workflow-id default

Exécute et affiche la progression

Les nœuds s’enchaînent comme dans l’éditeur.

Mode JSON (pour scripting)

bash
beemmvision --json workflow run --workflow-id default | jq '.run.artifacts[].url'

Extrait les URLs des images générées

Ce que le CLI exécute vraiment

Text, Number, Toggle, Seed
Import, File, List Selector, Array
Image Generation (catalogue de l’éditeur)
Prompt Enhancer, Any LLM, Image Describer
Concat, Layerize, Color Palette
Output To Board, Router, Preview
Crop, Blur, Invert, Channels, Levels
Video Frame

🟢 Exécuté comme dans l’app · 🟡 L’image transite telle quelle (le recadrage, le flou, etc. s’appliquent dans l’éditeur)

Génération par l’Agent Vision

Le CLI peut demander à l'Agent Vision de construire un workflow à partir d'une phrase. Dans le terminal, la commande s'appelle encore workflow samy-generate.

Générer un workflow

bash
beemmvision workflow samy-generate --workflow-id default --prompt "Crée un workflow éditorial avec prompt enhancer et image 1K"

L’Agent pose le graphe dans le workflow cible

Générer + Importer

bash
beemmvision workflow generate-and-import --workflow-id default --prompt "Pipeline de génération d'images avec 3 styles"

Génère et importe automatiquement

Générer + Importer + Exécuter

bash
beemmvision workflow generate-import-run --workflow-id default --prompt "Génère une image de paysage en 1K 1:1"

Le pipeline complet en une commande

Templates communautaires

Lister les templates

bash
beemmvision template list

Affiche les templates approuvés

Récupérer un template

bash
beemmvision template get --template-id TEMPLATE_ID

Récupère le workflow JSON du template

Cloner un template

bash
beemmvision template clone --template-id TEMPLATE_ID

Duplique le template dans un nouveau projet

Diagnostic

Vérifier l'état du CLI

bash
beemmvision doctor

Contrôle la connexion, l’URL de l’app et le projet courant

bash
beemmvision doctor --fix

Tente de corriger les réglages manquants

Si le diagnostic signale une session absente, lancez beemmvision auth login.

Exemples complets

Pipeline complet : Brief → LLM → Image

Créez un fichier JSON de workflow avec 3 noeuds (Brief → Any LLM → Nano Banana 2) et exécutez-le :

bash
beemmvision workflow import --input brief-llm-image.json
beemmvision workflow run --workflow-id imported-$(date +%s)

Import puis exécution (bash : id unique)

Sous Windows sans bash, remplacez imported-$(date +%s) par l'ID affiché après l'import ou utilisez WSL / Git Bash.

Scripting avec jq

bash
beemmvision --json workflow run --workflow-id default | jq -r '.run.artifacts[] | select(.kind == "image") | .url'

Extrait uniquement les URLs d'images

Workflow quotidien automatisé

bash
#!/bin/bash
beemmvision workflow generate-import-run \\
  --workflow-id default \\
  --prompt "Product shot minimaliste, fond blanc, éclairage studio" \\
  --json | jq -r '.run.artifacts[].url' | xargs open

macOS : génère, exécute et ouvre les images

La commande open est spécifique à macOS ; sous Linux essayez xdg-open, sous Windows WSL ou un script PowerShell avec Start-Process.

Ensuite

Appeler par APIUne clé, six routes, vos workflows.Le graphe dans l’appVoir ce que le CLI exécute.