CLI

Écrit par Jérémy DE CAMPOS

Dernière mise à jour Il y a 30 jours

Installation

sudo npm install -g @flowkode/cli

Vérifiez que l'installation a fonctionné :

flowkode --version

Mettre à jour

sudo npm install -g @flowkode/cli

npm remplace automatiquement l'ancienne version par la dernière disponible.

Connexion

Se connecter

flowkode login

Votre navigateur s'ouvre sur la page d'autorisation Flowkode. Cliquez sur Autoriser — le terminal confirme la connexion :

  Flowkode Login

  Ouverture du navigateur...
  En attente d'autorisation...

  ✓ Connecté en tant que vous@example.com
    Clé sauvegardée dans ~/.flowkode/config.json

    Essayez : flowkode projects list

Si le navigateur ne s'ouvre pas automatiquement, utilisez flowkode login --no-browser et copiez le lien affiché.

Se déconnecter

flowkode logout

Supprime la clé API de votre machine. Vous pourrez vous reconnecter à tout moment.

Configuration manuelle

Si vous préférez utiliser une clé API existante :

flowkode config --api-key ws_live_xxxxx

Voir votre configuration actuelle :

flowkode config --show

Projets

Lister vos projets

flowkode projects list

Filtrer par dossier :

flowkode projects list --folder ID_DU_DOSSIER

Voir le détail d'un projet

flowkode projects get ID_DU_PROJET

Affiche le nom, la description, les pages, le blog, le dernier déploiement, etc.

Créer un projet

Le CLI crée le projet et lance la génération IA automatiquement.

flowkode projects create \
  --name "Boulangerie Martin" \
  --type vitrine \
  --keywords "boulangerie, pain artisanal, pâtisserie, Lyon" \
  --language fr

Options disponibles :

OptionDescriptionObligatoire

-n, --name

Nom du projet

oui

-t, --type

vitrine ou affiliation

oui

-k, --keywords

Mots-clés SEO, séparés par des virgules

oui

-l, --language

Langue (fr, en, es, de, it, pt, nl, ar, ja, zh)

non (défaut : fr)

-d, --description

Description du site (générée par l'IA si absente)

non

--ai-model

ID du modèle IA à utiliser

non

La commande retourne un jobId. Utilisez-le pour suivre l'avancement.

Suivre la génération

flowkode jobs get ID_DU_JOB

Statuts possibles :

  • pending — en file d'attente

  • running — génération en cours

  • completed — terminé (le project_id est affiché)

  • failed — erreur (le message d'erreur est affiché)

Lister tous vos jobs :

flowkode jobs list
flowkode jobs list --status running

Modifier un projet

flowkode projects update ID_DU_PROJET --name "Nouveau nom"
flowkode projects update ID_DU_PROJET --description "Nouvelle description"
flowkode projects update ID_DU_PROJET --folder ID_DU_DOSSIER

Déploiement

Déployer un projet

Trois providers disponibles : GitHub, Vercel, Cloudflare.

# Déployer sur Vercel
flowkode projects deploy ID_DU_PROJET --provider vercel

# Déployer sur Cloudflare Pages
flowkode projects deploy ID_DU_PROJET --provider cloudflare

Déployer avec un domaine et configurer les DNS automatiquement :

flowkode projects deploy ID_DU_PROJET \
  --provider vercel \
  --domain ID_DU_DOMAINE \
  --configure-ns

Re-déployer

Relance le déploiement sur le dernier provider utilisé :

flowkode projects redeploy ID_DU_PROJET

Lister les déploiements

flowkode deployments list
flowkode deployments list --project ID_DU_PROJET
flowkode deployments list --provider vercel --status ready

Détail d'un déploiement

flowkode deployments get ID_DU_DEPLOIEMENT

Domaines

Lister vos domaines

flowkode domains list
flowkode domains list --registrar ovh
flowkode domains list --project ID_DU_PROJET

Vérifier la disponibilité

flowkode domains check monsite.com

Interroge tous vos registrars configurés et affiche les prix :

Registrar     Disponible  Prix    Devise
──────────────────────────────────────────
internetbs    true        9.99    USD
ovh           true        8.49    EUR
dynadot       true        8.99    USD

Acheter un domaine

flowkode domains purchase monsite.com --registrar ovh
flowkode domains purchase monsite.com --registrar internetbs --years 2

Synchroniser les domaines

Importe les domaines depuis vos registrars dans Flowkode :

flowkode domains sync

Associer un domaine à un projet

flowkode domains associate ID_DU_DOMAINE --project ID_DU_PROJET

Dissocier un domaine

flowkode domains dissociate ID_DU_DOMAINE

Configurer les DNS

Configure automatiquement les DNS vers le déploiement associé :

flowkode domains dns ID_DU_DOMAINE

Vérifier la propagation DNS

flowkode domains propagation ID_DU_DOMAINE

Modifier un domaine

Déplacer dans un dossier :

flowkode domains update ID_DU_DOMAINE --folder ID_DU_DOSSIER

Supprimer un domaine

Le domaine doit être dissocié avant d'être supprimé :

flowkode domains dissociate ID_DU_DOMAINE
flowkode domains delete ID_DU_DOMAINE

Dossiers

Les dossiers permettent d'organiser vos projets et domaines.

Lister les dossiers

flowkode folders list

Créer un dossier

flowkode folders create --name "Clients 2026"
flowkode folders create --name "Sites e-commerce" --color blue

Couleurs disponibles : gray, red, orange, amber, green, blue, violet, pink.

Modifier un dossier

flowkode folders update ID_DU_DOSSIER --name "Nouveau nom"
flowkode folders update ID_DU_DOSSIER --color green
flowkode folders update ID_DU_DOSSIER --position 0

Supprimer un dossier

Les projets et domaines du dossier sont déplacés à la racine :

flowkode folders delete ID_DU_DOSSIER

Blog

Lister les articles

flowkode blog list
flowkode blog list --project ID_DU_PROJET
flowkode blog list --status published

Statuts possibles : pending, queued, running, generated, scheduled, published, error.

Voir le détail d'un article

flowkode blog get ID_DE_L_ARTICLE

Générer des articles

Lancez la génération d'articles à partir de mots-clés :

flowkode blog generate ID_DU_PROJET --keywords "react" "nextjs" "typescript"

Publier automatiquement après génération :

flowkode blog generate ID_DU_PROJET --keywords "seo" "marketing" --auto-publish

Indexation Google

Vérifier si un article est indexé :

flowkode blog indexing ID_DE_L_ARTICLE

Lancer une vérification :

flowkode blog indexing-check ID_DE_L_ARTICLE

Soumettre un article pour indexation :

flowkode blog indexing-submit ID_DE_L_ARTICLE

Google Search Console

Lister les comptes connectés

flowkode search-console accounts

Enregistrer un site

flowkode search-console add-site ID_DU_PROJET

Voir le statut

flowkode search-console status ID_DU_PROJET

Soumettre le sitemap

flowkode search-console submit-sitemap ID_DU_PROJET

Workflows

Les workflows sont des commandes qui enchaînent automatiquement plusieurs étapes. Ils fonctionnent aussi bien pour un usage humain que pour des agents IA appelant le CLI.

Suivre un job en temps réel

Attendez la fin d'un job de génération avec un affichage en temps réel :

flowkode watch-job ID_DU_JOB

Options :

OptionDescriptionDéfaut

-i, --interval <seconds>

Intervalle de polling

3

--timeout <minutes>

Timeout maximum

10

La commande bloque jusqu'à ce que le job soit completed ou failed, puis affiche le résultat.

Lancer un site complet

Crée un site, attend la génération, déploie, et configure un domaine — le tout en une seule commande :

flowkode launch-site \
  --name "Boulangerie Martin" \
  --type vitrine \
  --keywords "boulangerie, pain artisanal, Lyon" \
  --provider vercel

Avec achat de domaine et configuration DNS :

flowkode launch-site \
  --name "Boulangerie Martin" \
  --type vitrine \
  --keywords "boulangerie, pain artisanal, Lyon" \
  --provider vercel \
  --domain boulangerie-martin.com \
  --registrar ovh

Options :

OptionDescriptionObligatoire

-n, --name

Nom du site

oui

-t, --type

vitrine ou affiliation

oui

-k, --keywords

Mots-clés SEO

oui

-l, --language

Langue

non (défaut : fr)

-d, --description

Description du site

non

-m, --model

Modèle IA

non

-p, --provider

Provider de déploiement (vercel, cloudflare)

non

--domain

Domaine à acheter

non

--registrar

Registrar (internetbs, ovh, dynadot)

non

Étapes exécutées :

  1. Création du projet (mode rapide)

  2. Attente de la génération IA

  3. Déploiement (si --provider spécifié)

  4. Achat du domaine (si --domain et --registrar spécifiés)

  5. Association du domaine au projet + configuration DNS

Campagne SEO

Génère des articles de blog, les publie et les soumet à Google pour indexation :

flowkode seo-campaign ID_DU_PROJET \
  --keywords "react" "nextjs" "typescript" "tailwind" "vercel"

Sans indexation automatique :

flowkode seo-campaign ID_DU_PROJET \
  --keywords "seo" "marketing" \
  --no-indexing

Sans publication automatique :

flowkode seo-campaign ID_DU_PROJET \
  --keywords "seo" "marketing" \
  --no-publish

Étapes exécutées :

  1. Génération des articles (1 par mot-clé)

  2. Récupération des articles publiés

  3. Soumission de chaque article à Google pour indexation

Audit SEO

Génère un rapport SEO complet pour un projet :

flowkode audit-seo ID_DU_PROJET

Le rapport inclut :

  • Informations du projet (nom, URL de déploiement)

  • Statut d'indexation Google (pages et articles)

  • Statut Search Console

  • Articles de blog (total, répartition par statut, liste)

Migrer un domaine

Migre un domaine d'un projet à un autre en une seule commande :

flowkode migrate-domain ID_DU_DOMAINE --target ID_DU_PROJET_CIBLE

Sans reconfiguration DNS :

flowkode migrate-domain ID_DU_DOMAINE --target ID_DU_PROJET_CIBLE --no-dns

Sans vérification de propagation :

flowkode migrate-domain ID_DU_DOMAINE --target ID_DU_PROJET_CIBLE --no-propagation

Étapes exécutées :

  1. Dissociation de l'ancien projet (ignoré si pas associé)

  2. Association au projet cible

  3. Reconfiguration DNS (sauf --no-dns)

  4. Vérification de la propagation DNS (sauf --no-propagation)

Autres commandes

Indexation d'un projet

Voir le statut d'indexation Google de toutes les pages et articles d'un projet :

flowkode projects indexing ID_DU_PROJET

Formulaires de contact

flowkode contact-forms
flowkode contact-forms --category devis

Modèles IA disponibles

flowkode ai-models

Mentions légales

flowkode legal-notices

Projets d'affiliation

flowkode affiliation list
flowkode affiliation get ID_DU_PROJET_AFFILIATION

Options globales

Ces options fonctionnent avec toutes les commandes :

OptionDescription

--json

Affiche le résultat en JSON brut

--version

Affiche la version du CLI

--help

Affiche l'aide

Mode JSON

Utile pour intégrer le CLI dans des scripts ou du CI/CD :

# Récupérer la liste des projets en JSON
flowkode --json projects list

# Extraire les noms avec jq
flowkode --json projects list | jq '.data[].name'

# Récupérer l'URL du dernier déploiement
flowkode --json deployments list --project ID --status ready | jq '.data[0].url'

Utilisation dans GitHub Actions

name: Deploy

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Deploy to Vercel
        env:
          FLOWKODE_API_KEY: ${{ secrets.FLOWKODE_API_KEY }}
        run: npx @flowkode/cli projects deploy ${{ vars.PROJECT_ID }} --provider vercel

Dépannage

"API key required"

Vous n'êtes pas connecté. Lancez :

flowkode login

"Invalid API key" ou "API key has been revoked"

Votre clé n'est plus valide. Reconnectez-vous :

flowkode logout
flowkode login

"Rate limit exceeded"

L'API autorise 100 requêtes par heure. Attendez quelques minutes avant de réessayer.

Le navigateur ne s'ouvre pas

Utilisez l'option --no-browser et copiez le lien manuellement :

flowkode login --no-browser

"Timeout — aucune réponse reçue du navigateur"

Le CLI attend 5 minutes. Si vous n'avez pas autorisé dans ce délai, relancez flowkode login.

Voir la configuration actuelle

flowkode config --show

Réinitialiser la configuration

rm ~/.flowkode/config.json
flowkode login