Projets

Un projet est l'espace de travail principal de ThreadMind. Il regroupe une arborescence de threads, un contexte système et une configuration.

Créer un projet

project_create(title: "Mon App", systemContext: "...", mode: "solo")

Ou avec le raccourci : tm:project Mon App

Cela va :

1. Générer un ID à partir du titre ("Mon App" → "mon-app")
2. Créer le fichier de configuration du projet
3. Créer le thread racine main
4. Générer votre identifiant auteur si vous n'en avez pas encore (depuis git config user.name + un hash court de git config user.email)
5. En faire le projet actif de la session

Paramètres

Paramètre	Type	Défaut	Description
title	string	requis	Nom lisible du projet
systemContext	string	""	Prompt système global inclus dans chaque assemblage de contexte
mode	"solo" | "team"	"solo"	Mode de collaboration

Contexte système

Le systemContext est une instruction globale qui apparaît en haut de chaque contexte assemblé, quel que soit le thread actif. Utilisez-le pour :

• Décisions techniques globales ("Nous utilisons TypeScript en mode strict")
• Vue d'ensemble de l'architecture ("Monorepo avec frontend Next.js et backend Express")
• Conventions de code ("Utiliser des composants fonctionnels, pas de classes")

TIP

Claude Code et les autres clients qui lisent les instructions de serveur MCP utilisent ThreadMind automatiquement. Pour les autres agents, exécutez tm:init (ou threadmind_init) pour générer un fichier AGENTS.md.

Lister les projets

project_list

Ou avec le raccourci : tm:projects

Retourne tous les projets avec leur mode et met en évidence le projet actif :

- Mon App (mon-app) [solo] ← actif
- Projet Perso (projet-perso) [solo]
- Projet Équipe (projet-equipe) [team]

Changer de projet

project_switch(projectId: "projet-perso")

Change le projet de la session. Son thread actif est choisi comme au démarrage d'une session : le dernier utilisé sur la branche récupérée, le thread lié à cette branche, ou main (voir Threads).

Quand un dépôt n'a qu'un projet, il est sélectionné automatiquement — par exemple dans un clone tout neuf.

Modes de projet

Mode Solo

Mode par défaut. Aucune restriction de propriété — vous pouvez modifier le résumé de n'importe quel thread.

Mode Équipe

Active les workflows collaboratifs via git. Voir Mode équipe pour les détails.

Différence clé : en mode équipe, vous ne pouvez mettre à jour que les résumés des threads que vous avez créés. Vous pouvez toujours créer des threads enfants à partir de n'importe quel thread.

Stockage

Chaque projet crée :

.threadmind/
  projects/
    mon-app.json          # Configuration du projet
  threads/
    mon-app/
      main.md             # Thread racine
      ...                 # Autres threads (chacun enregistre son parent)

Génération d'ID

Les IDs de projet sont auto-générés par slugification du titre :

Titre	ID généré
"Mon App"	mon-app
"Plateforme E-Commerce"	plateforme-e-commerce
"API v2"	api-v2

Si l'ID existe déjà, un suffixe numérique est ajouté : mon-app-2, mon-app-3, etc.