🧠 NotaMy

NotaMy est un gestionnaire de notes techniques hiérarchique conçu pour le terminal, visant à réduire le coût mental du changement de contexte pour les personnes travaillant sur des tâches d'analyse de longue durée (pentesting, rétro-ingénierie, wargames).

🎯 Pourquoi NotaMy a été créé

Lorsque j'ai commencé à travailler sur des activités de pentesting et d'analyse binaire, j'ai rapidement réalisé quelque chose :

Le problème n'est pas de prendre des notes, c'est de les gérer dans le temps.

Une analyse peut durer des jours ou des mois. Pendant ce temps, vous accumulez des adresses mémoire, des sorties de tests, des désassemblages, des comportements suspects, des tentatives échouées, des idées à vérifier — et tout cela finit souvent dispersé dans des fichiers et dossiers.

Le résultat ? De la confusion. Chercher continuellement des informations dans des fichiers éparpillés interrompt le flux mental et ralentit l'investigation.

NotaMy a été créé pour supprimer cette friction : réduire le coût du changement de contexte tout en gardant toutes les informations accessibles depuis le shell, organisées et recherchebles.

🧩 Qu'est-ce que NotaMy

NotaMy n'est pas un éditeur de texte. Ce n'est pas un système Markdown. Ce n'est pas une application graphique.

C'est un système minimal, orienté terminal, pour organiser les connaissances techniques dans des fichiers de notes (contextes) et des structures hiérarchiques d'arbres de nœuds/étiquettes.

⚙️ Fonctionnalités clés :

• Plusieurs fichiers de notes (contextes) avec changement rapide de contexte
• Structure hiérarchique de nœuds avec étiquettes, commentaires, texte étendu, mots-clés et références de fichiers
• Recherche structurée (par étiquette, mot-clé, contenu)
• Flux de travail entièrement piloté par le clavier
• Conçu pour des flux de travail techniques longs et complexes

🗂️ Le concept central

Chaque fichier de notes représente un projet ou une investigation. Changer de fichier, c'est changer d'espace mental.

Exemple :

ntm view file

Vous pouvez changer de contexte avec :

ntm setting 2

🌳 Structure hiérarchique

Les notes sont organisées en nœuds dans un arbre. Chaque nœud peut contenir :

• Une étiquette (mot-clé principal)
• Un commentaire (post-it visible dans l'arbre)
• Un corps de texte long
• Des références de fichiers
• Des mots-clés pour la recherche

Vous pouvez stocker un post-it ou un livre entier. Tout au même endroit.

Exemple :

ntm view note

# indique que la note contient du texte développable.

Vous pouvez développer chaque nœud pour voir son contenu :

ntm view note -b

🔄 Flux de travail (comment je l'utilise)

• Je crée ou sélectionne le fichier de notes (contexte).
• J'ajoute un nœud avec une étiquette et un commentaire :

ntm add note -t "TAG" -c "Commentaire court"

• Si nécessaire, j'écris un texte plus long avec l'éditeur configuré (vim par défaut) :

ntm add note -t "TAG" -c "Commentaire" -b

L'éditeur s'ouvre, j'enregistre et je quitte, et le corps est inséré dans la note.

• Je lie des fichiers (exploit, binaire, configuration) directement à la note et j'utilise des mots-clés pour tout retrouver rapidement.

👤 À qui cela s'adresse

NotaMy est conçu pour ceux qui :

• vivent dans le terminal
• travaillent sur des tâches techniques longues et complexes
• gèrent plusieurs projets simultanément
• veulent de la structure sans interface graphique
• préfèrent le clavier à la souris

🚫 Pour qui ce n'est PAS

Ce n'est probablement pas pour vous si :

• vous voulez une synchronisation cloud
• vous avez besoin de collaboration multi-utilisateurs
• vous voulez une interface graphique moderne
• vous voulez rédiger des documents Markdown

NotaMy est minimal et ciblé.

📝 Bref historique

NotaMy est né d'un besoin personnel :

Réduire le coût mental du changement de contexte.

Les notes ne sont pas le problème. La complexité l'est.

En 2020, j'ai commencé avec une version basique appelée "Note Management" : du texte structuré simple. C'était déjà utile. Puis sont venus MemoKeeper et MemoKeeperX, avec des fichiers et des étiquettes séparés. Avec le temps, cela est devenu une partie de mon flux de travail quotidien : pentesting, études, idées et petits projets.

NotaMy est la version mature de ce flux de travail : minimal, fiable et adapté à ma façon de travailler.

Vous voulez savoir pourquoi et comment NotaMy est né ? Lisez la PHILOSOPHIE du projet.

🚀 Installation

git clone https://github.com/IMprojtech/NotaMy.git
cd NotaMy
make
./bin/ntm

Ajouter NotaMy à votre PATH

Après avoir compilé ntm, vous voudrez peut-être l'exécuter depuis n'importe où sans taper le chemin complet. Voici une approche courante :

Installer dans un répertoire déjà dans votre PATH

1. Copiez ou déplacez le binaire compilé vers un emplacement standard, par exemple :

sudo cp ./bin/ntm /usr/local/bin/
sudo cp ./bin/ntm_nc /usr/local/bin/

Ou, si vous préférez une installation locale (sans sudo) :

mkdir -p "$HOME/.local/bin"
cp ./bin/ntm "$HOME/.local/bin/"
cp ./bin/ntm_nc "$HOME/.local/bin/"

Assurez-vous que ce répertoire est dans votre PATH. La plupart des distributions Linux incluent /usr/local/bin par défaut. Si vous avez utilisé ~/.local/bin, vérifiez que votre fichier d'initialisation du shell l'ajoute au PATH. Par exemple, dans ~/.bashrc ou ~/.zshrc :

# Ajoutez ceci si ce n'est pas déjà présent :
export PATH="$HOME/.local/bin:$PATH"

Sinon, vous pouvez directement ajouter le répertoire bin à votre fichier d'initialisation du shell :

export PATH="$HOME/chemin/vers/NotaMy/bin:$PATH"

🐚 Intégration Zsh optionnelle

NotaMy fournit une enveloppe Zsh optionnelle qui améliore l'expérience utilisateur sans modifier le programme C principal.

L'enveloppe ajoute :

• Commande ntm enveloppée avec une gestion améliorée de la sortie
• Pagination automatique via bat
• Détection correcte du TTY
• Fonction fview pour la visualisation interactive des notes (fzf + bat)
• Fonction nocolor pour supprimer les séquences d'échappement ANSI
• Changement temporaire de fichier de notes via un préfixe numérique

Changement temporaire de fichier de notes

L'enveloppe permet de changer temporairement le fichier actif en plaçant son numéro avant la commande :

ntm 1 view note

Installation

Ajoutez le fichier du plugin à votre ~/.zshrc :

source /chemin/vers/NotaMy/shell/zsh/notamy.plugin.zsh

Puis rechargez votre shell :

source ~/.zshrc

⚠️ L'intégration Zsh est complètement optionnelle. L'application C principale fonctionne indépendamment.

📘 Documentation

Un manuel d'utilisation complet est disponible avec les instructions d'installation, des exemples d'utilisation et toutes les commandes prises en charge :

📄 Lire le manuel de NotaMy

⚖️ Licence

Ce programme est distribué sous les termes de la GNU General Public License (GPL), garantissant la liberté de redistribuer et de modifier le logiciel conformément aux standards du logiciel libre.

✍️ Auteur

Écrit par Catoni Mirko (IMprojtech)