Git и GitHub -- страховка для твоих заметок

Зачем это нужно (без программирования)

Представь: ты полгода ведёшь базу знаний в Obsidian. 300 заметок, связи, шаблоны, ежедневные записи. И вдруг:

• Случайно удалил важную заметку
• AI-агент переписал файл не так, как ты хотел
• Ноутбук сломался / украли / залил кофе
• Хочешь вернуться к версии заметки, которая была неделю назад

Без Git -- у тебя проблема. С Git -- ты нажимаешь одну кнопку и всё возвращается.

Git -- это система версий для файлов. Как "история изменений" в Google Docs, но для всей папки целиком. Каждый раз, когда ты "сохраняешь точку" (коммит), Git запоминает состояние всех файлов. Можно откатиться к любой точке в прошлом.

GitHub -- это облачное хранилище для твоего Git-репозитория. Как Dropbox, но умнее: хранит не только файлы, а всю историю изменений. Если ноутбук сгорит -- все заметки и вся история в облаке.

Три вещи, которые Git даёт непрограммисту

1. Машина времени

Ты можешь вернуться к любому сохранённому моменту. Заметка была лучше три дня назад? Откатил. Агент наломал дров? Откатил. Случайно удалил папку? Откатил.

2. Страховка от агента

На курсе мы даём AI-агенту доступ к файлам. Он может читать, писать и удалять заметки. Это мощно -- но иногда агент делает не то, что ты хочешь. Git -- твоя сеть безопасности. Перед запуском агента на большую задачу -- сохраняешь точку. Если что-то пошло не так -- одна команда, и всё как было.

3. Облачный бэкап

GitHub хранит копию всех твоих заметок в облаке. Потерял компьютер -- скачал на новый за 30 секунд. Хочешь работать с двух устройств -- синхронизация через GitHub.

И кстати это бесплатно ;)

Словарь на 5 слов

Забудь всё, что слышал про ветки, мёрджи и пул-реквесты. Для работы с Obsidian нужно ровно 5 слов:

Слово	Что значит	Аналогия
repo (репозиторий)	Папка, за которой следит Git	Твой Obsidian vault
commit (коммит)	Сохранённая точка	"Сохранить игру"
push (пуш)	Отправить изменения в облако	"Залить в облако"
pull (пулл)	Скачать изменения из облака	"Скачать с облака"
diff (дифф)	Показать, что изменилось	"Что нового?"

Вот и всё. Больше не нужно.

Начальная настройка (один раз)

Шаг 1: Установить Git

macOS: Git уже установлен. Проверь в терминале:

git --version

Если не установлен -- macOS предложит установить Command Line Tools. Согласись.

Windows: скачай с git-scm.com и установи. Или в PowerShell:

winget install Git.Git

Шаг 2: Представиться Git

Git подписывает каждый коммит твоим именем. Введи в терминале:

git config --global user.name "Твоё Имя"
git config --global user.email "твой@email.com"

Это делается один раз. Email не обязательно реальный -- это просто подпись.

Шаг 3: Создать репозиторий из vault

Открой терминал, перейди в папку с Obsidian vault и инициализируй Git:

cd ~/путь/к/твоему/vault
git init

Теперь Git следит за этой папкой.

Шаг 4: Первый коммит

git add .
git commit -m "первый коммит: мой vault"

Готово. Ты только что сохранил первую точку. Теперь можно откатываться к этому моменту в любое время.

Кстати ты можешь сказать агенту, чтобы он закоммитил и он справится с гитом сам.

Шаг 5 (опционально): Подключить GitHub

1. Зарегистрируйся на github.com (бесплатно)
2. Создай новый приватный репозиторий (кнопка "New repository", отметь "Private")
3. Подключи:

git remote add origin https://github.com/ТВОЙ_ЛОГИН/ИМЯ_РЕПО.git
git push -u origin main

Или просто скажи агенту, чтобы подключил репозиторий и дай ему ссылку. Он сам все сделает.

Теперь твои заметки в облаке. Приватный репозиторий -- никто кроме тебя не видит.

Ежедневная работа: три команды

Или еженедельная. Здесь нет жестких правил.

Посмотреть, что изменилось

git status

Покажет список файлов, которые изменились с последнего коммита. Полезно перед сохранением -- чтобы понимать, что ты сохраняешь.

Сохранить точку (коммит)

git add .
git commit -m "обновил заметки за среду"

Первая команда -- "добавить все изменения". Вторая -- "сохранить с описанием".

Описание в кавычках -- любой текст. Пиши для себя: "добавил конспект книги", "почистил inbox", "агент обновил daily notes".

Вообще агент по твоей команде сам все сделает. Но я хочу чтобы у тебя было понимание, как это работает.

Залить в облако

git push

Отправляет все коммиты в GitHub. Делай регулярно -- и у тебя всегда будет свежий бэкап.

Когда что-то пошло не так

Агент сделал не то

Посмотри, что изменилось:

git diff

Если нужно откатить ВСЕ изменения до последнего коммита:

git checkout .

Всё вернётся к состоянию последнего сохранения.

Случайно удалил файл

git checkout -- "путь/к/файлу.md"

Файл восстановится из последнего коммита.

Хочу вернуться к версии недельной давности

git log --oneline

Покажет список всех сохранений с короткими ID. Найди нужный момент и:

git checkout abc1234 -- "путь/к/файлу.md"

Это вернёт конкретный файл к конкретной точке.

Пусть агент делает коммиты за тебя

Самый удобный подход -- не набирать git-команды руками, а попросить AI-агента.

В CLAUDE.md

Добавь правило в CLAUDE.md:

## Git
- Делай коммит после каждой завершённой задачи
- Описание коммита: на русском, кратко, что сделано
- Перед большими изменениями -- обязательный коммит (точка отката)

В разговоре с агентом

Просто скажи:

Сохрани текущее состояние в git с описанием "обработал inbox за неделю"

Или даже так:

Сохрани текущее состояние в git. Описание придумай сам)

Или:

Покажи, что изменилось с последнего коммита

Или:

Откати последние изменения -- мне не нравится результат

Агент выполнит нужные git-команды за тебя. Тебе не нужно запоминать синтаксис -- нужно только понимать концепцию: "сохрани точку" и "откатись к точке".

Скилл /commit

На курсе мы создадим скилл, который делает коммит одной командой:

/commit

Агент сам посмотрит, что изменилось, напишет описание и сохранит. Ты просто подтверждаешь.

.gitignore -- что НЕ сохранять

Не всё в vault нужно хранить в Git. Создай файл .gitignore в корне vault:

.obsidian/workspace.json
.obsidian/workspace-mobile.json
.trash/
.DS_Store

Это исключает временные файлы Obsidian и корзину. Всё остальное -- сохраняется.

💬 Промпт для LLM: Скопируй и вставь в Claude или ChatGPT:

Помоги мне настроить .gitignore для моего Obsidian vault. Vault содержит: заметки, шаблоны, изображения, плагины. Какие файлы стоит исключить из git? Объясни почему для каждого паттерна.

FAQ

Это бесплатно? Git -- бесплатный. GitHub -- бесплатный для приватных репозиториев (ограничение: файлы до 100 МБ, репозиторий до 5 ГБ). Для обычного Obsidian vault -- за глаза.

Это безопасно? Приватный репозиторий на GitHub виден только тебе. GitHub использует шифрование. Если паранойя -- используй Git без GitHub (только локально) или self-hosted решения (Gitea, Forgejo).

А что, если я запутаюсь? Git спроектирован так, что потерять данные очень сложно. Даже если ты наберёшь "неправильную" команду -- данные обычно можно восстановить. А с AI-агентом -- ты вообще можешь попросить: "помоги, я запутался в git, покажи статус и объясни".

Можно синхронизировать между устройствами? Да. На каждом устройстве: git pull (скачать свежее), работаешь, git push (залить). Для автосинхронизации есть плагины Obsidian (Git plugin), но ручной push/pull надёжнее.

Чем это лучше iCloud / Dropbox? iCloud синхронизирует файлы. Git синхронизирует файлы + всю историю изменений. С iCloud, если ты удалил файл неделю назад -- его нет. С Git -- он есть в истории. Плюс Git показывает, ЧТО изменилось в каждом файле, а не просто "файл обновился".

Минимум для старта

Если из всего гайда запомнить только одно:

1. git init -- один раз
2. git add . && git commit -m "описание" -- после важных изменений
3. git checkout . -- если агент наломал дров

Три команды. Пять минут настройки. Бесконечная страховка.

💬 Промпт для LLM: Скопируй и вставь в Claude или ChatGPT:

Я абсолютный новичок в Git. Мой Obsidian vault находится в [путь]. Проведи меня пошагово: 1) инициализация Git, 2) первый коммит, 3) подключение GitHub. После каждого шага жди подтверждения, что получилось. Объясняй каждую команду простым языком.