Second Brain OS : construire une base de connaissances auto-organisée avec Claude Code

Pour qui

• Pour toute personne qui souhaite utiliser Claude Code pour construire une base de connaissances qui s'organise toute seule : vous collectionnez des articles et des notes, et vous voulez qu'ils soient automatiquement extraits, reliés entre eux et maintenus bien rangés, plutôt que de s'entasser dans des fichiers que plus personne ne relit.
• Le projet fournit un guide complet, un coffre initial, des agent skills et des scripts, qui fonctionnent autour de fichiers markdown, de wikilinks et de SKILL.md ; il convient aussi à tout agent capable de lire des fichiers. Obsidian n'est qu'un visualiseur de graphe, pas une dépendance.
• Ce n'est pas adapté si vous voulez un logiciel de prise de notes graphique prêt à l'emploi et que vous n'êtes pas disposé à cloner un dépôt dans un terminal, à copier des répertoires et à lancer un agent. Les preuves officielles ne précisent pas quels clients sont pris en charge au-delà des agents mentionnés, quelles langues textuelles sont prises en charge, ni quelles restrictions existent en dehors de la gratuité et de l'absence de compte — c'est gratuit, sans inscription, mais les autres limites sont inconnues.

Premier essai en 3 minutes

Le chemin principal indiqué par les sources officielles consiste à installer localement dans ~/brain via le terminal, puis à lancer Claude Code dans ce répertoire :

1. Prérequis : git et Claude Code (l'agent) doivent être installés ; installer Obsidian en plus est recommandé pour consulter le graphe.
2. Exécutez dans le terminal les commandes d'installation officielles, qui copient le coffre initial ainsi que les skills, commands et agents dans ~/brain/.claude :

git clone https://github.com/undefined-ui/second-brain-os.git
cp -r second-brain-os/vault-template ~/brain

mkdir -p ~/brain/.claude
cp -r second-brain-os/skills   ~/brain/.claude/skills
cp -r second-brain-os/commands ~/brain/.claude/commands
cp -r second-brain-os/agents   ~/brain/.claude/agents

cd ~/brain && claude

1. Effets secondaires et points de vérification : ces commandes créent ~/brain dans votre répertoire utilisateur et y écrivent des fichiers ; si la cible existe déjà, vérifiez d'abord vous-même si vous souhaitez l'écraser.
2. Déclenchez une première tâche à faible risque : enregistrez/collez un article sous forme de fichier dans le répertoire raw/, puis tapez /ingest dans Claude Code. C'est le workflow officiel central : l'agent ingère, extrait, crée les liens et nettoie la matière brute pour en faire un wiki interconnecté. Il lit et écrit les fichiers markdown à l'intérieur du coffre ; savoir s'il exécute des commandes ou accède au réseau n'est pas précisé par les preuves officielles — à considérer comme inconnu. Si l'article contient des informations sensibles, anonymisez-le avant de le placer dans raw/.
3. Signal de réussite : les articles de raw/ sont transformés en pages de notes avec wikilinks dans le coffre ; la règle officielle est "Nothing is ingested until it is linked" — si les liens ne sont pas créés dans le même tour, l'ingestion n'est pas terminée. Vérifiez donc que les nouvelles pages contiennent réellement des liens vers d'autres notes : c'est le critère pour savoir si un tour de /ingest est achevé. Les preuves officielles ne précisent pas quels contrôles sont inclus dans /ingest ni s'il existe des flux différents selon les types de texte ; n'émettez aucune hypothèse à ce sujet.

Cas d'usage

Cas 1 : archivage d'articles collectionnés. Vous coupez des articles depuis votre navigateur sans jamais les relire. Scénario : enregistrez un article coupé dans ~/brain/raw/, puis lancez /ingest dans Claude Code. L'agent suit le workflow d'ingestion officiel — extraction des points clés, création de liens vers les notes existantes et nettoyage. Résultat attendu : les fichiers bruts deviennent des pages de wiki reliées entre elles ; si vous constatez que les nouvelles pages manquent de liens, selon la règle officielle l'ingestion du tour est incomplète et vous pouvez demander à l'agent de compléter les liens.

Cas 2 : consulter le graphe de connaissances avec Obsidian. Scénario : après quelques ingest, vous voulez vérifier les connexions entre les notes. Méthode : ouvrez le coffre ~/brain dans Obsidian (Obsidian est le visualiseur de graphe mentionné par les sources officielles) et parcourez le graphe formé par les notes et les wikilinks. Ce qui est confirmé : le coffre est composé uniquement de markdown et de wikilinks, qu'Obsidian peut ouvrir directement pour afficher le graphe ; les sources officielles ne mentionnent aucune automatisation ni synchronisation plus poussée — n'attendez pas d'intégration au-delà du rôle de visualiseur.

Limites d'utilisation

• Accès aux fichiers : l'installation et l'exécution créent et modifient des fichiers markdown en local (~/brain, raw/, le répertoire .claude) ; c'est le cœur du processus, pas un effet secondaire facultatif.
• Commandes et réseau : les preuves officielles ne donnent que les commandes shell d'installation ci-dessus ; savoir si l'agent exécute d'autres commandes ou accède au réseau pendant l'ingestion n'est pas précisé — cela reste inconnu.
• Points de vérification : examinez vous-même les documents sensibles avant de les placer dans raw/ ; confirmez vous-même avant d'écraser un ~/brain existant.
• Environnement d'exécution : il faut un terminal local, git et un agent capable de lire des fichiers (le chemin officiel utilise Claude Code) ; Obsidian est nécessaire pour la vue en graphe, mais ce n'est pas une dépendance. Les sources officielles ne mentionnent aucune autre restriction d'exécution.
• Informations clés non confirmées : la liste des agents pris en charge se limite-t-elle à Claude Code (les sources officielles disent seulement works with Claude Code and any agent that reads files), les langues textuelles prises en charge, et les commandes disponibles en dehors de /ingest — aucune preuve n'existe ; avant utilisation, vous pouvez vérifier les fichiers réels dans les répertoires skills et commands.