Foxmayn Cowork : un agent IA en terminal pour vos fichiers

Ce que fait l'outil

Cowork est une interface en terminal (TUI) où vous discutez avec un modèle des fichiers d'un dossier. Vous demandez en langage courant. Il travaille dans le dossier choisi et nulle part ailleurs : tout chemin qui en sort, y compris par un lien symbolique, est refusé. Il s'adresse à celles et ceux qui aiment le terminal et veulent de l'aide pour les corvées de fichiers : lire une pile de PDF, renommer un lot de fichiers, modifier des notes, chercher dans un projet.

Trois factures PDF lues et totalisées en une seule demande. Un dossier fictif, avec Claude Haiku 5.5 via OpenRouter.

Fonctionnalités

• 16 outils de fichiers : lister, trouver, lire, chercher dans le contenu, créer fichiers et dossiers, modifier, corriger par rechercher-remplacer, copier, renommer et supprimer.
• Opérations groupées : supprimer ou renommer une liste de fichiers, ou tous ceux dont le nom correspond à un motif, avec une seule confirmation.
• Lecture de PDF. Cowork lit le texte des fichiers PDF.
• Confirmation avant chaque modification, renommage et suppression, et avant de créer ou copier quoi que ce soit dans un chemin caché comme .git. --skip-confirmations la désactive le temps d'une session, avec un badge rouge à l'écran.
• Le modèle de votre choix : OpenRouter (par défaut), Ollama, ou un modèle GGUF local via llama.cpp, dans un build depuis les sources avec --features local.
• Sessions enregistrées par dossier. /sessions les liste et /resume en reprend une.
• Commandes slash avec autocomplétion : /dir change de dossier, /model change de modèle, /clear repart de zéro. Tapez / pour voir les autres.

Avant une suppression, Cowork liste chaque fichier et attend y.

Installation

Linux et macOS :

curl -fsSL https://raw.githubusercontent.com/nasroykh/foxmayn_cowork_cli/main/install.sh | sh

Windows PowerShell :

irm https://raw.githubusercontent.com/nasroykh/foxmayn_cowork_cli/main/install.ps1 | iex

Les versions publiées couvrent Linux et macOS (x86_64 et aarch64) et Windows x86_64. Windows sur ARM utilise la version x86_64. Les scripts vérifient la somme de contrôle SHA-256 de chaque téléchargement avant l'installation. Ces versions n'incluent pas le fournisseur de modèle local : pour lui, compilez depuis les sources.

Premier lancement

Au premier lancement, une courte configuration s'ouvre : choisissez un fournisseur, puis collez une clé OpenRouter ou indiquez votre serveur Ollama. Les réglages sont enregistrés dans foxmayn-cowork/.env, dans le dossier de configuration de votre compte (~/.config sous Linux). foxmayn-cowork config permet de les changer ensuite.

Ouvrez ensuite un dossier :

foxmayn-cowork --dir ~/documents/factures

Lancé sans --dir, Cowork attend que vous choisissiez un dossier avec /dir.

Pourquoi nous l'avons construit

Nous voulions un assistant qui travaille sur les fichiers comme le ferait un collègue assis au même bureau. Demandez-lui de lire les factures de mars et d'en donner les totaux. Le modèle fait la lecture. Vous gardez la main grâce au dossier que vous choisissez et à l'étape de confirmation.

Les modèles locaux comptent ici. Avec Ollama, ou un modèle GGUF dans un build avec --features local, vos fichiers ne quittent jamais votre machine. Ce build ne compile pas encore sous macOS. Avec OpenRouter, vous choisissez le modèle et payez à l'usage, et les fichiers que lit le modèle sont envoyés à ce fournisseur.

Cowork est écrit en Rust. La CI vérifie le formatage, clippy et les tests sous Linux, macOS et Windows, contrôle la version minimale de Rust (1.89) et lance cargo audit. La licence est MIT. Le code source et les tickets sont sur GitHub. Pour une IA qui travaille sur votre ERP plutôt que sur vos fichiers, voyez Foxmayn Frappe CLI.