🧠 NotaMy

NotaMy es un gestor jerárquico de notas técnicas basado en terminal, diseñado para reducir el costo mental de cambiar de contexto en tareas de análisis de larga duración (pentesting, ingeniería inversa, wargames).

🎯 Por qué se creó NotaMy

Cuando empecé a trabajar en actividades de pentesting y análisis de binarios, me di cuenta rápidamente de algo:

El problema no es tomar notas, sino gestionarlas a lo largo del tiempo.

Un análisis puede durar días o meses. Durante ese tiempo, acumulas direcciones de memoria, salidas de pruebas, desensamblados, comportamientos sospechosos, intentos fallidos, ideas por verificar — y todo esto a menudo termina disperso en archivos y carpetas.

¿El resultado? Confusión. Buscar información continuamente entre archivos dispersos interrumpe el flujo mental y ralentiza la investigación.

NotaMy se creó para eliminar esta fricción: reducir el costo de cambiar de contexto, manteniendo toda la información accesible desde el shell, organizada y buscable.

🧩 Qué es NotaMy

NotaMy no es un editor de texto. No es un sistema de markdown. No es una aplicación gráfica.

Es un sistema mínimo, centrado en la terminal, para organizar conocimiento técnico en archivos de notas (contextos) y estructuras jerárquicas de árbol de nodos/etiquetas.

⚙️ Características principales:

• Múltiples archivos de notas (contextos) con cambio rápido de contexto
• Estructura jerárquica de nodos con etiquetas, comentarios, texto extendido, palabras clave y referencias a archivos
• Búsqueda estructurada (por etiqueta, palabra clave, contenido)
• Flujo de trabajo completamente basado en teclado
• Diseñado para flujos de trabajo técnicos largos y complejos

🗂️ El concepto central

Cada archivo de nota representa un proyecto o investigación. Cambiar de archivo significa cambiar de espacio mental.

Ejemplo:

ntm view file

Puedes cambiar de contexto con:

ntm setting 2

🌳 Estructura jerárquica

Las notas se organizan como nodos en un árbol. Cada nodo puede contener:

• Etiqueta (palabra clave principal)
• Comentario (post-it visible en el árbol)
• Cuerpo de texto largo
• Referencias a archivos
• Palabras clave para búsqueda

Puedes almacenar un post-it o un libro entero. Todo en el mismo lugar.

Ejemplo:

ntm view note

# indica que la nota contiene texto expandible.

Puedes expandir cada nodo para ver su contenido:

ntm view note -b

🔄 Flujo de trabajo (cómo lo uso)

• Creo o selecciono el archivo de notas (contexto).
• Añado un nodo con etiqueta y comentario:

ntm add note -t "ETIQUETA" -c "Comentario corto"

• Si es necesario, escribo un texto más largo usando el editor configurado (vim por defecto):

ntm add note -t "ETIQUETA" -c "Comentario" -b

El editor se abre, guardo y salgo, y el cuerpo se inserta en la nota.

• Enlazo archivos (exploit, binario, configuración) directamente a la nota y uso palabras clave para recuperar todo rápidamente.

👤 Para quién es

NotaMy está diseñado para quienes:

• viven en la terminal
• trabajan en tareas técnicas largas y complejas
• gestionan múltiples proyectos simultáneamente
• quieren estructura sin interfaces gráficas
• prefieren el teclado al ratón

🚫 Para quién NO es

Probablemente no es para ti si:

• quieres sincronización en la nube
• necesitas colaboración multiusuario
• quieres una interfaz gráfica moderna
• quieres escribir documentos markdown

NotaMy es mínimo y enfocado.

📝 Breve historia

NotaMy nació de una necesidad personal:

Reducir el costo mental de cambiar de contexto.

Las notas no son el problema. La complejidad sí.

En 2020, empecé con una versión básica llamada "Note Management": texto estructurado simple. Ya era útil. Luego llegaron MemoKeeper y MemoKeeperX, con archivos y etiquetas separados. Con el tiempo, se convirtió en parte de mi flujo de trabajo diario: pentesting, estudio, ideas y pequeños proyectos.

NotaMy es la versión madura de ese flujo de trabajo: mínimo, fiable y adaptado a la forma en que trabajo.

¿Quieres saber por qué y cómo nació NotaMy? Lee la FILOSOFÍA del proyecto.

🚀 Instalación

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

Añadir NotaMy a tu PATH

Después de compilar ntm, es posible que quieras ejecutarlo desde cualquier lugar sin escribir la ruta completa. Aquí hay un enfoque común:

Instalar en un directorio ya en tu PATH

1. Copia o mueve el binario compilado a una ubicación estándar, por ejemplo:

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

O, si prefieres una instalación local (sin sudo):

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

Asegúrate de que ese directorio esté en tu PATH. La mayoría de las distribuciones Linux incluyen /usr/local/bin por defecto. Si usaste ~/.local/bin, verifica que tu archivo de inicialización del shell lo añada al PATH. Por ejemplo, en ~/.bashrc o ~/.zshrc:

# Añade esto si aún no está presente:
export PATH="$HOME/.local/bin:$PATH"

Alternativamente, puedes añadir directamente el directorio bin a tu archivo de inicialización del shell:

export PATH="$HOME/ruta/hacia/NotaMy/bin:$PATH"

🐚 Integración opcional con Zsh

NotaMy proporciona un envoltorio opcional para Zsh que mejora la experiencia del usuario sin modificar el programa C principal.

El envoltorio añade:

• Comando ntm envuelto con mejor manejo de salida
• Paginación automática mediante bat
• Detección adecuada de TTY
• Función fview para visualización interactiva de notas (fzf + bat)
• Función nocolor para eliminar secuencias de escape ANSI
• Cambio temporal de archivo de notas mediante prefijo numérico

Cambio temporal de archivo de notas

El envoltorio permite cambiar temporalmente el archivo activo colocando su número antes del comando:

ntm 1 view note

Instalación

Añade el archivo del plugin a tu ~/.zshrc:

source /ruta/hacia/NotaMy/shell/zsh/notamy.plugin.zsh

Luego recarga tu shell:

source ~/.zshrc

⚠️ La integración con Zsh es completamente opcional. La aplicación C principal funciona de forma independiente.

📘 Documentación

Hay un manual de usuario completo disponible con instrucciones de instalación, ejemplos de uso y todos los comandos soportados:

📄 Leer el manual de NotaMy

⚖️ Licencia

Este programa se distribuye bajo los términos de la GNU General Public License (GPL), garantizando la libertad de redistribuir y modificar el software según los estándares del software libre.

✍️ Autor

Escrito por Catoni Mirko (IMprojtech)