🧠 NotaMy

NotaMy — это иерархический менеджер технических заметок, работающий в терминале и созданный для снижения ментальных затрат на переключение контекста при выполнении долгосрочных задач анализа (pentesting, реверс-инжиниринг, wargames).

🎯 Зачем был создан NotaMy

Когда я начал заниматься пентeстингом и анализом бинарных файлов, я быстро осознал одну вещь:

Проблема не в том, чтобы делать заметки, — проблема в том, чтобы управлять ими с течением времени.

Анализ может длиться дни или месяцы. За это время накапливаются адреса памяти, результаты тестов, дизассемблированные данные, подозрительное поведение, неудачные попытки, идеи, которые нужно проверить — и всё это часто оказывается разбросанным по файлам и папкам.

Результат? Путаница. Постоянный поиск информации по разрозненным файлам прерывает поток мыслей и замедляет исследование.

NotaMy был создан, чтобы устранить это трение: снизить стоимость переключения контекста, сохранив при этом доступ ко всей информации из командной строки, организованной и доступной для поиска.

🧩 Что такое NotaMy

NotaMy — это не текстовый редактор. Это не система Markdown. Это не графическое приложение.

Это минимальная система, работающая в терминале, предназначенная для организации технических знаний в файлы заметок (контексты) и иерархические древовидные структуры узлов/тегов.

⚙️ Ключевые возможности:

• Несколько файлов заметок (контексты) с быстрым переключением между ними
• Иерархическая структура узлов с тегами, комментариями, расширенным текстом, ключевыми словами и ссылками на файлы
• Структурированный поиск (по тегу, ключевому слову, содержимому)
• Полностью управление с клавиатуры
• Разработан для длительных и сложных технических рабочих процессов

🗂️ Основная концепция

Каждый файл заметок представляет собой проект или исследование. Переключение файлов означает смену ментального пространства.

Пример:

ntm view file

Вы можете переключить контекст с помощью:

ntm setting 2

🌳 Иерархическая структура

Заметки организованы в виде узлов в дереве. Каждый узел может содержать:

• Тег (основное ключевое слово)
• Комментарий (видимый стикер в дереве)
• Длинный текст
• Ссылки на файлы
• Ключевые слова для поиска

Вы можете хранить стикер или целую книгу. Всё в одном месте.

Пример:

ntm view note

# означает, что заметка содержит раскрываемый текст.

Вы можете развернуть каждый узел для просмотра его содержимого:

ntm view note -b

🔄 Рабочий процесс (как я это использую)

• Я создаю или выбираю файл заметок (контекст).
• Добавляю узел с тегом и комментарием:

ntm add note -t "TAG" -c "Краткий комментарий"

• При необходимости я пишу более длинный текст в настроенном редакторе (по умолчанию vim):

ntm add note -t "TAG" -c "Комментарий" -b

Открывается редактор, я сохраняю и выхожу, и текст вставляется в заметку.

• Связываю файлы (эксплойт, бинарник, конфиг) прямо с заметкой и использую ключевые слова для быстрого поиска всего.

👤 Для кого это

NotaMy создан для тех, кто:

• живёт в терминале
• работает над долгими и сложными техническими задачами
• одновременно ведёт несколько проектов
• хочет структурированность без графических интерфейсов
• предпочитает клавиатуру мыши

🚫 Для кого это НЕ подходит

Вероятно, это не для вас, если:

• вам нужна синхронизация в облаке
• требуется совместная работа нескольких пользователей
• вы хотите современный графический интерфейс
• вы хотите писать документы в Markdown

NotaMy минимален и сфокусирован.

📝 Краткая история

NotaMy родился из личной потребности:

Снизить ментальные затраты на переключение контекста.

Заметки — не проблема. Проблема — сложность.

В 2020 году я начал с базовой версии под названием «Note Management»: простой структурированный текст. Это уже было полезно. Затем появились MemoKeeper и MemoKeeperX с отдельными файлами и тегами. Со временем это стало частью моего ежедневного рабочего процесса: pentesting, учёба, идеи и небольшие проекты.

NotaMy — это зрелая версия этого рабочего процесса: минимальная, надёжная и адаптированная к тому, как я работаю.

Хотите узнать, почему и как родился NotaMy? Прочитайте PHILOSOPHY проекта.

🚀 Установка

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

Добавление NotaMy в ваш PATH

После компиляции ntm вы можете захотеть запускать его откуда угодно, не вводя полный путь. Вот распространённый подход:

Установка в каталог, уже находящийся в PATH

1. Скопируйте или переместите скомпилированный бинарный файл в стандартное место, например:

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

Или, если вы предпочитаете локальную установку (без sudo):

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

Убедитесь, что этот каталог находится в вашем PATH. Большинство дистрибутивов Linux включают /usr/local/bin по умолчанию. Если вы использовали ~/.local/bin, убедитесь, что ваш файл инициализации оболочки добавляет его в PATH. Например, в ~/.bashrc или ~/.zshrc:

# Добавьте это, если ещё не присутствует:
export PATH="$HOME/.local/bin:$PATH"

В качестве альтернативы вы можете напрямую добавить каталог bin в файл инициализации оболочки:

export PATH="$HOME/path/to/NotaMy/bin:$PATH"

🐚 Необязательная интеграция с Zsh

NotaMy предоставляет необязательную обёртку для Zsh, которая улучшает пользовательский опыт без изменения основной программы на C.

Обёртка добавляет:

• Команду ntm с улучшенной обработкой вывода
• Автоматическую пагинацию с помощью bat
• Правильное определение TTY
• Функцию fview для интерактивного просмотра заметок (fzf + bat)
• Функцию nocolor для удаления escape-последовательностей ANSI
• Временное переключение файлов заметок с помощью числового префикса

Временное переключение файлов заметок

Обёртка позволяет временно переключить активный файл, указав его номер перед командой:

ntm 1 view note

Установка

Добавьте файл плагина в ваш ~/.zshrc:

source /path/to/NotaMy/shell/zsh/notamy.plugin.zsh

Затем перезагрузите оболочку:

source ~/.zshrc

⚠️ Интеграция с Zsh полностью необязательна. Основное приложение на C работает независимо.

📘 Документация

Полное руководство пользователя доступно с инструкциями по установке, примерами использования и всеми поддерживаемыми командами:

📄 Читать руководство по NotaMy

⚖️ Лицензия

Эта программа распространяется на условиях Стандартной общественной лицензии GNU (GPL), что обеспечивает свободу распространения и модификации программного обеспечения в соответствии со стандартами свободного программного обеспечения.

✍️ Автор

Автор: Catoni Mirko (IMprojtech)