lesson 06

Développement de l'IA

Les scènes Monocurl sont des fichiers texte brut et les LLM peuvent être très utiles pour éviter les tâches de mise en page passe-partout et fastidieuses.

An AI agent editing a Monocurl scene while the desktop app previews the result

Statut actuel

Monocurl dispose d'un serveur MCP (Model Context Protocol) qui permet aux assistants IA compatibles de lire directement la documentation de Monocurl, la référence stdlib, les notes CLI et les exemples de scènes en tant que ressources structurées. C'est la méthode recommandée pour donner un contexte Monocurl à un assistant IA.

Le serveur est publié sur npm sous le nom @enigmurl/monocurl-mcp. Il s'agit uniquement d'un serveur de documentation. Il ne modifie pas les scènes, n'exécute pas Monocurl, ne rend pas les images et ne valide pas le code.

Pour un client MCP qui accepte la configuration du serveur stdio, ajoutez :

{
  "mcpServers": {
    "monocurl": {
      "command": "npx",
      "args": ["-y", "@enigmurl/monocurl-mcp"]
    }
  }
}

Pour Claude Code, la commande équivalente est :

claude mcp add --transport stdio monocurl -- npx -y @enigmurl/monocurl-mcp

Pour le Codex, ajoutez ceci à ~/.codex/config.toml :

[mcp_servers.monocurl]
command = "npx"
args = ["-y", "@enigmurl/monocurl-mcp"]

Après l'avoir installé, demandez à l'assistant de lire les ressources Monocurl MCP avant d'écrire une scène.

Exemple d'invite

Vous pouvez coller quelque chose comme ceci dans un assistant de codage IA :

You are helping me write a Monocurl scene. Monocurl is a programming language and desktop app for creating mathematical animations with live preview, video export, and slideshow-style presentation.

Install and use the Monocurl MCP context server before writing code. If your MCP client supports stdio servers, add a server named monocurl with:

command: npx
args: ["-y", "@enigmurl/monocurl-mcp"]

Then read the Monocurl MCP resources, especially the language overview, stdlib docs, CLI guide, and example scenes.

When writing and testing Monocurl code, keep these points in mind:

1. If the `monocurl` binary is not on PATH, look for the application binary manually. On macOS, check `/Applications`, `~/Applications`, or the app bundle contents. On Windows, check `Program Files` for `Monocurl.exe`. The binary can run scenes and inspect print output.
2. Be mindful when sizing text. Text sizes smaller than `0.5` are typically illegible. Prefer larger text that is easy to read during presentations.
3. In most cases, do not explicitly specify the variables to animate. The default behavior animates all dirty leaders, so the variables list can usually be left as `[]`.
4. Your sandbox may not have access to a GPU device, so CLI image or video rendering may fail. Use print statements and the transcript command heavily to check positioning, values, and the general structure of the scene.

Mode sans tête

Monocurl surveillera les modifications de fichiers et mettra à jour dynamiquement la chronologie et la fenêtre d'affichage en réponse à toute modification externe, y compris celles des agents IA. Par conséquent, vous pouvez utiliser votre éditeur de texte préféré ou un agent IA pour écrire le fichier source de la scène, puis revenir à l'éditeur Monocurl pour voir les résultats et parcourir la chronologie. Si vous préférez utiliser l'espace de gauche pour un terminal au lieu de l'éditeur par défaut, activez le menu sans tête dans le menu Fichier.