Référence › Commandes › Start

Référence › Commandes

Démarrer

Les commandes qui créent un projet et qui donnent de l’aide.

Commandes : archec new · archec help · archec config

Commande Ce qu’elle fait
archec help [--all | <command>] Les commandes de tous les jours. Avec --all, toutes les commandes, classées selon leur usage. Pour une commande : son usage, ses options et un exemple (comme archec <command> --help).
archec config [show [main.arche]] | ai offline|local-ai|online | allow <service> [url] | deny <service> [url] | remove <service> [url] | local-ai <url> [model] | services | test <service> [url] Ce qui peut quitter cette machine (ai-engineering.md). Rien, par défaut : ai online laisse review, live-fix et new --describe envoyer à Claude, ai local-ai à un modèle sur cette machine (local-ai http://localhost:11434 qwen3-coder). allow store https://store.arche-lang.xyz (ou polarion, parts, issues, libraries, sigstore, github) laisse sortir ce service. C’est écrit dans ~/.arche/config.json. La politique de l’organisation (ARCHE_POLICY, /etc/arche/policy) et le projet (ai, allow, deny, private) peuvent seulement la restreindre, et la CI ne la lit pas. show affiche le mode en vigueur et d’où vient chaque réglage. test dit si un appel sortirait. Toute commande accepte --offline, --ai <mode>, --allow service[=url] et --show-sent. Chaque appel est noté dans .arche/egress.log.
archec new [dir] [--template <id|owner/name>] [--board <id>] [--name <name>] [--parts "a -> b, b -> c"] [--target none|c|embassy|go] [--handlers typescript|python|arche] [--yes] [--dry-run] Un nouveau projet qui passe la vérification sans erreur, plutôt qu’une page blanche (new.md). Il part d’un modèle de projet fourni avec archec — blank (par défaut), rover-esp32, can-sensor-node (STM32G4 et CAN), drone-fc (un contrôleur de vol) — ou d’un modèle du store (owner/name). --board ajoute une carte du store de cartes (ou remplace par elle celle du modèle de projet). --parts ajoute des parts et des liens (lidar -> planner ; un nom seul est une part). --target écrit un déploiement pour archec gen s’il n’y en a pas (go fixe language go). Le projet indique handlers typescript (son comportement en TypeScript, handlers.md), sauf si --handlers en indique un autre ou si le code de départ est en Python. Les corps ```arche du modèle de projet sont traduits dans ce langage. Chaque étape est vérifiée comme le fait archec check. Une étape qui ajouterait une erreur est laissée de côté, avec une note. La commande écrit main.arche, README.md et .gitignore. Dans un terminal, elle pose ses questions (ce que vous construisez, la carte, les parts, le code), chacune seulement si aucune option n’y a répondu. --yes prend les valeurs par défaut. --dry-run affiche les fichiers et n’écrit rien.
archec new <dir> --kind firmware|service|containers|ros2|desktop|library|robot [--target c|embassy|go] [--no-run] Un projet d’un type donné, qui tourne déjà (new.md). Il contient le modèle de projet du type, son déploiement et son code généré : le code à compléter va dans src/ (versionné, ses régions USER CODE conservées), le reste dans generated/ (ignoré). S’y ajoutent un premier test pour chaque part qu’aucun plan de test ne nomme, des fichiers de CI à la racine (.github/workflows/archec.yml, .gitlab-ci.yml : archec ci, puis le code généré, compilé et testé), .vscode/ (extensions recommandées, tâches build, test et live) et un README avec les commandes. Vient ensuite la première exécution : archec check, archec test, archec gen, puis le build et les tests du type. Chaque étape est annoncée, avec une ligne de bilan à la fin (first run: simulated 500 ms, built (make), 4/4 tests pass). Si un outil manque sur cet ordinateur ou si un démon ne tourne pas, son étape est sautée avec une note. Une étape qui échoue donne le code de sortie 1. --no-run saute la première exécution. --dry-run n’écrit rien et ne lance rien. Sans --kind, dans un terminal, la première question porte sur le type.
archec new <dir> --kind robot --describe "unscrew a bottle cap" Un petit bras et une tâche dans MuJoCo (robot-prototyping.md). La phrase choisit la scène, robot-draw, robot-cap ou robot-cube (et, pour robot-draw, la forme et la taille). Hors ligne, ce sont ses mots qui décident. Avec une IA autorisée (ai local-ai, online), le modèle répond une scène, une forme et une taille, vérifiées, à travers la passerelle. Une réponse qui n’en est pas une retombe sur les mots. Le planificateur va sur un Raspberry Pi Pico. Son C se compile et tourne ici. Avec le Python de MuJoCo, le plan de test tourne contre le bras.
archec new --first-run [dir] Relance la première exécution dans un projet créé par archec new --kind (son .archec/kind.json indique le type) : vérifier, simuler, générer, compiler, tester. Code de sortie 1 si une étape échoue.
archec new <dir> --from <owner/name[@range]> [--store <where>] Remix : un paquet quelconque du store (une architecture, un modèle de projet, une carte…) copié dans un nouveau projet. C’est une copie modifiable, pas une dépendance uses. Elle est vérifiée comme le fait archec add (hash, signature, confiance). Le projet reçoit derived-from "owner/name@version". Ce que le paquet utilise du store est récupéré avec archec add. Un paquet sans fichier principal en reçoit un qui inclut ses fichiers.
archec new <dir> --describe "a robot with 2 motors, a lidar and a Raspberry Pi" [--kind <id>] [--board <id>] [--rounds 4] [--model id] [--dry-run] Claude (claude-opus-5-5) écrit le premier modèle à partir d’une phrase. Il reçoit une référence compacte du langage, les cartes du store de cartes et un modèle de projet comme exemple. Sa réponse est vérifiée comme le fait archec check, et les erreurs lui sont renvoyées, jusqu’à --rounds fois. C’est un premier jet à relire, pas un verdict. Du texte part à l’extérieur : votre description et les messages d’archec check sur ce que Claude a écrit sont envoyés à l’API Anthropic, uniquement quand cette commande s’exécute. --dry-run affiche le prompt et n’envoie rien. Identifiants : ANTHROPIC_API_KEY. Le type est celui de --kind, sinon celui que nomment les mots de la phrase (firmware, esp32, stm32… : les mots propres à chaque type). --dry-run indique lequel. Hors ligne par défaut : archec config ai online (ou ai local-ai, un modèle sur cette machine) l’autorise à envoyer (ai-engineering.md).