EN
Utilisation

Contexte et fichiers

Ajouter du contexte à une session avec --files ou --context tout en gardant le contrôle sur les données transmises.

Palabre peut envoyer du contexte projet aux agents. C'est indispensable pour demander une critique de code, d'architecture ou de documentation.

Deux modes

OptionUsage
--filesVous choisissez explicitement les fichiers. Un chemin invalide arrête la commande.
--contextPalabre scanne des fichiers ou dossiers texte avec des limites et des exclusions.

--files est strict : un fichier binaire, un dossier ou un chemin invalide arrête la session. --context est tolérant : il parcourt les dossiers, ignore les fichiers non retenus et affiche des avertissements sans annuler la session. Les deux options partagent les plafonds décrits dans « Portée et exclusions ».

Fichiers explicites

palabre codex-claude "Relis ce module" --files src/auth.ts README.md

Utilisez --files quand vous savez exactement quels fichiers doivent être envoyés.

Scan de contexte

palabre codex-claude "Critique cette architecture" --context src docs

--context ignore les dossiers techniques courants comme .git, node_modules et dist. Il garde les fichiers texte connus et affiche des avertissements pour les fichiers ignorés, les extensions non supportées, les fichiers trop gros et les chemins manquants. Ces avertissements n'arrêtent pas la session.

Depuis l'accueil TUI

Les mêmes options fonctionnent directement dans le composer de l'accueil, à la fin du sujet :

Critique cette architecture --context src docs

Palabre retire --context et --files du sujet et injecte les fichiers correspondants. Les chemins contenant des espaces ne sont pas supportés dans cette syntaxe inline : utilisez la ligne de commande classique dans ce cas. L'en-tête de session confirme le nombre de fichiers injectés sur la ligne Contexte.

Prévisualiser le scan en JSON

palabre context scan src docs --json

Cette commande expose le même scan que --context, sans lancer de session. Elle renvoie un JSON versionné avec la racine scannée, les chemins demandés, les dossiers et fichiers retenus, ainsi que les avertissements. Les intégrations comme l'extension VS Code doivent utiliser cette commande au lieu de réimplémenter les règles d'exclusion ou de limite.

Ollama et les fichiers

Ollama ne lit pas le filesystem par lui-même. Il reçoit seulement le prompt construit par Palabre.

Si un agent Ollama participe à une session sur votre projet, ajoutez explicitement du contexte :

palabre codex-ollama "Critique ce module" --context src

Voir le prompt envoyé

palabre codex-claude "Sujet" --context src --show-prompt

Cette commande ne lance aucun agent. Elle permet de vérifier ce que Palabre enverra au premier tour.

Portée et exclusions

--files et --context partagent un budget de 64 Kio par fichier et 192 Kio au total ; les fichiers explicites sont chargés en premier. --context ignore avec avertissement les fichiers trop gros, binaires ou au-delà du budget. Le scan exclut aussi .tmp et .pnpm-store et lit les règles simples du .gitignore racine ; les négations ! ne sont pas prises en charge.

Les agents CLI sont lancés depuis le dossier courant et peuvent lire le projet avec leurs propres outils, selon leur configuration. Les fichiers injectés sont marqués comme données non fiables ; ces limites ne sont pas un confinement. Ollama ne lit pas les fichiers lui-même ; PALABRE avertit s'il participe sans contexte. En Ask, --show-prompt montre le prompt du premier agent.

Relay n'accepte ni --files ni --context : la cible garde son contexte. Utilisez --message-file pour un long message.