Aperçu du CLI

Crée un nouveau projet de documentation.

jamdesk init              # Interactive mode
jamdesk init my-docs      # Create in new directory

Cela crée un nouveau projet avec :

• Un fichier de configuration docs.json
• Des pages MDX d'exemple
• Une structure de dossiers recommandée

Connectez-vous à Jamdesk via votre navigateur. Requis avant de déployer.

jamdesk login

Ouvre le dashboard Jamdesk dans votre navigateur pour l'authentification. Les identifiants sont stockés localement dans ~/.jamdeskrc.

Efface les identifiants stockés.

jamdesk logout

Affiche l'utilisateur actuellement authentifié et vérifie que votre session est valide.

jamdesk whoami

Valide votre configuration docs.json, la syntaxe MDX et les spécifications OpenAPI.

jamdesk validate
jamdesk validate --skip-mdx

Vérifie :

• La syntaxe JSON valide dans docs.json
• Les champs requis (name, navigation)
• Les valeurs de thème valides
• Les erreurs de syntaxe MDX (par exemple, des caractères < non échappés)
• La validation des spécifications OpenAPI (si configurées)
• La conformité au schéma

Options :

Exécutez cette commande avant de déployer pour détecter les erreurs rapidement.

Analyse votre documentation à la recherche de liens internes rompus.

jamdesk broken-links

Exemple de sortie :

docs/getting-started.mdx:15 - /docs/quikstart
  Did you mean: /docs/quickstart

Found 1 broken link in 45 files.

Détecte les liens vers des pages manquantes et les fautes de frappe. Consultez Liens et navigation pour plus de détails.

Corrige automatiquement les avertissements de liens internes rompus dont la cible est sans ambiguïté. Gère deux catégories :

• Ancres avec faute de frappe : un fragment comme #instalation qui devrait clairement être #installation
• Dérive d'ancre inter-locale : une page traduite a renommé ses titres, mais les liens de cette locale pointent encore vers l'ancien fragment anglais

# Preview what would change without touching any files
jamdesk fix --dry-run

# Apply fixes (prompts for confirmation)
jamdesk fix

Exemple de sortie en dry-run :

Planned fixes:

  fr/ai/overview.mdx:9
    /fr/ai/selectors#ai-strategies  →  /fr/ai/selectors#stratégies-ia

(dry run — no files written)

Une correction n'est écrite que lorsque l'ancre corrigée correspond à un titre réel dans la page cible. Les cas ambigus sont laissés pour une révision manuelle.

Options :

Vérifie l'orthographe de votre documentation.

jamdesk spellcheck

Exemple de sortie :

getting-started.mdx:14 - "recieve"
  └─ Did you mean: receive

Found 3 misspellings across 24 pages.
Tip: Run "jamdesk spellcheck --fix" to interactively fix or ignore words.

Utilise un dictionnaire anglais avec plus de 150 termes techniques intégrés (API, GraphQL, Kubernetes, React, etc.) afin que le jargon courant ne soit pas signalé. Ignore les blocs de code, le code en ligne, le frontmatter, le JSX, les URLs et les chemins de fichiers. Actuellement en anglais uniquement ; la prise en charge d'un dictionnaire multilingue est prévue.

Options :

Mode de correction interactif (--fix) parcourt chaque mot mal orthographié unique :

1/10  "recieve" — found in 3 files
      intro.mdx:14, setup.mdx:7, guide.mdx:22

? What do you want to do?
❯ Fix → receive (recommended)
  Fix → relieve
  Ignore in the future (add to docs.json)
  Skip

• Fix remplace le mot par une suggestion dans tous les fichiers (sans risque pour le code, il ne modifie donc pas les blocs de code ni les attributs JSX). Jusqu'à 3 suggestions sont affichées, la meilleure correspondance étant marquée comme recommandée.
• Ignore ajoute le mot à spellcheck.ignore dans votre docs.json afin qu'il ne soit plus signalé
• Skip ne fait rien pour cette exécution

Les changements sont prévisualisés et confirmés avant d'être appliqués.

Liste d'exclusion personnalisée : ajoutez des termes spécifiques à votre projet dans votre docs.json :

{
  "spellcheck": {
    "ignore": ["YourProduct", "kubectl", "Terraform"]
  }
}

Le nom de votre projet issu de docs.json est automatiquement ignoré.

Valide un unique fichier de spécification OpenAPI.

jamdesk openapi-check openapi.yaml
jamdesk openapi-check api/spec.json

Valide :

• La syntaxe YAML/JSON valide
• La conformité au schéma OpenAPI 3.x
• Les définitions d'endpoint
• La résolution correcte des références $ref

Renomme une page et met automatiquement à jour toutes les références.

jamdesk rename docs/old-name.mdx docs/new-name.mdx

Cela va :

• Renommer le fichier
• Mettre à jour la navigation dans docs.json
• Mettre à jour les liens dans tous les autres fichiers MDX
• Mettre à jour les références aux snippets

Utilisez cette commande plutôt qu'un renommage manuel pour garder toutes les références synchronisées.

Migre la documentation depuis Mintlify vers Jamdesk.

jamdesk migrate

Détecte votre configuration Mintlify et la convertit au format Jamdesk. Dans la même opération, elle renomme les composants dépréciés (par exemple CardGroup → Columns), déplace les fichiers MDX de snippets orphelins vers /snippets/ et réécrit les imports relatifs au parent, extrait les composants en ligne utilisant des hooks React vers /snippets/<name>.tsx avec 'use client', et corrige automatiquement les problèmes mécaniques de syntaxe MDX. Idempotente, vous pouvez donc la relancer en toute sécurité.

Téléverse votre documentation et déclenche un build directement depuis le terminal.

jamdesk deploy
jamdesk deploy --detach
jamdesk deploy --full-rebuild

La progression s'affiche en direct à mesure que chaque phase du build se termine. Également disponible sous la forme jamdesk push.

Génère et déploie un Cloudflare Worker qui redirige /docs sur votre propre domaine vers votre site Jamdesk.

jamdesk deploy-proxy cloudflare
jamdesk deploy-proxy cloudflare --slug myproject --domain example.com --skip-deploy --yes

Interactif par défaut : il vérifie Wrangler, valide votre compte Cloudflare, détecte automatiquement votre slug depuis docs.json, génère les fichiers du Worker, et effectue éventuellement le déploiement.

Vérifie votre environnement et diagnostique les problèmes.

jamdesk doctor

Vérifie :

• La version de Node.js (nécessite v20+)
• La version de npm
• L'existence et la validité de docs.json
• Le statut du cache ~/.jamdesk
• Les permissions d'écriture

Exécutez cette commande si vous rencontrez des problèmes avec le CLI.

Efface le répertoire de cache ~/.jamdesk.

jamdesk clean

Cela supprime les dépendances mises en cache et les artefacts de build. Utilisez-le pour :

• Libérer de l'espace disque
• Résoudre les problèmes de cache corrompu
• Forcer une nouvelle installation des dépendances

Les dépendances seront réinstallées au prochain jamdesk dev.

Met à jour le CLI vers la dernière version.

jamdesk update

Vous pouvez aussi mettre à jour manuellement :

npm update -g jamdesk