Персональный AI-ассистент с долговременной памятью

Записывайте голосовые в Telegram — агент сам разберётся что с ними делать: сохранит мысли, обновит прогресс по целям, поставит себе напоминание и напишет вам, когда придёт время.

Главное перед началом

Что изменилось в версии 3.0 (если коротко):

• Установка стала сильно проще: одна команда запускает скрипт, который сам ставит всё необходимое и сам задаёт вам вопросы.
• Ключей нужно меньше: всего два (Telegram и Deepgram) плюс ваш Telegram ID.
• Напоминания и расписания агент теперь делает сам — никаких внешних таск-менеджеров подключать не нужно.
• Внутри теперь живёт одна постоянная сессия Claude Code — она работает на вашей обычной подписке Claude Pro/Max.

Оглавление

• Зачем это нужно
• Как это работает
• Словарь терминов
• Что понадобится
• Часть 1: Подготовка на компьютере ⏱ 30–50 мин
  • 1.1 Установите Git и VS Code
  • 1.2 Создайте аккаунт на GitHub
  • 1.3 Сделайте Fork проекта
  • 1.4 Клонируйте Fork на компьютер
  • 1.5 Заполните ваши цели
  • 1.6 Настройте профиль
  • 1.7 Настройте систему под себя
  • 1.8 Сохраните изменения в GitHub
• Часть 2: Получите ключи ⏱ 10 мин
  • 2.1 Telegram Bot Token
  • 2.2 Ваш Telegram ID
  • 2.3 Deepgram API Key
• Часть 3: Настройка сервера ⏱ 30–50 мин
  • 3.1 Купите VPS и подключитесь
  • 3.2 Создайте пользователя
  • 3.3 Запустите установку (одна команда)
  • 3.4 Авторизуйте Claude Code
• Часть 4: Использование
• Часть 5: Синхронизация
• Обновление с прошлых версий
• Помощь

Зачем это нужно

Это система управления мыслями, заметками и напоминаниями «на стероидах». Один раз настроите — и у вас всегда под рукой понимание, что происходит в жизни.

Кидайте туда вообще всё:

• Интересные посты из Telegram — пересылайте боту
• Скриншоты — отправляйте
• После встречи — надиктуйте голосом что было и какие решения
• Эмоции, мысли, идеи — всё записывайте
• Ссылки, цитаты, заметки — абсолютно всё

Самое крутое — с ним можно просто разговаривать

Это полноценный AI-агент. В версии 3.0 не нужно нажимать никаких специальных кнопок — просто пишете или наговариваете боту что угодно, и он сам разберётся что делать.

Примеры того, что можно попросить:

Вы общаетесь с ним как с настоящим ассистентом. Он сам найдёт нужные файлы, обновит структуру, поставит напоминание — всё автоматически. Никаких внешних таск-менеджеров: напоминания и расписания агент создаёт сам себе, встроенным планировщиком.

Чем больше вы делитесь информацией и чем лучше заполните цели и карточку о себе — тем лучше агент понимает ваш контекст и тем точнее расставляет приоритеты.

Про Claude Code — не бойтесь названия. Да, он называется «Code», но это универсальный AI-агент, который отлично помогает в жизни. У него чёткие инструкции как действовать с вашими записями — сохранять мысли, следить за целями, напоминать о важном. Он просто работает.

Если вы запутались на каком-то шаге

Не переживайте! Откройте ChatGPT или Claude и напишите: «Помоги разобраться с этой инструкцией, я застрял на шаге [номер шага]. Вот ссылка: https://github.com/ВАШ_ЛОГИН/agent-second-brain»

Он прочитает инструкцию и поможет вам пошагово.

Как это работает

1. Вы отправляете голосовое/текст/фото в Telegram
2. Бот на сервере принимает сообщение (голос превращается в текст за секунды)
3. Claude Code — живая сессия агента — читает его и отвечает вам прямо в чат
4. Мысли и заметки сохраняются в Obsidian-хранилище, напоминания агент ставит себе сам
5. Вечером в 21:00 агент обрабатывает все записи за день и присылает отчёт в Telegram
6. Всё синхронизируется в GitHub

Что значит «постоянная сессия» (и почему это важно)

В прошлых версиях бот на каждое сообщение запускал отдельную копию Claude — как если бы вы для каждого вопроса нанимали нового ассистента, объясняли ему всё с нуля, а потом увольняли.

В версии 3.0 на сервере живёт одна постоянная, открытая сессия Claude Code — тот же интерактивный Claude Code, который разработчики запускают у себя в терминале. Бот просто «печатает» ваши сообщения в это открытое окно и забирает ответы. Окно никогда не закрывается: его держит программа tmux (см. словарь ниже), а специальный сторож-процесс следит, чтобы сессия была живой, и перезапускает её, если что-то пошло не так.

Почему это здорово:

• Работает на обычной подписке Claude Pro или Max — это интерактивное использование Claude Code, полностью по правилам подписки. Никакой оплаты за каждый запрос.
• Агент помнит контекст разговора: можно сказать «а теперь добавь туда ещё один пункт» — и он поймёт, о чём речь.
• Напоминания срабатывают в отдельной, второй сессии — так сработавший будильник никогда не перебьёт ваш разговор с ботом.

Словарь терминов

Если какие-то слова незнакомы — вот короткий словарь:

Что понадобится

Итого: ~$25/мес

Напоминания и расписания делает сам агент — отдельный таск-менеджер не нужен и не стоит ни копейки.

Где взять VPS

Нужен сервер НЕ в России/Беларуси — там блокировка Claude по территории.

• Contabo — $4.96/мес, работает с белорусскими картами
• OVH — $5/мес, тоже работает с белорусскими картами

Часть 1: Подготовка на компьютере ⏱ 30–50 мин

1.1 Установите Git и VS Code

Что это такое:

• Git — программа для скачивания и синхронизации проектов
• VS Code — бесплатный редактор файлов (как Word, но для настроек и кода)

Если у вас Windows:

1. Откройте браузер и перейдите по ссылке: git-scm.com/download/win
2. Скачивание начнётся автоматически. Дождитесь окончания.
3. Откройте папку «Загрузки» на вашем компьютере
4. Найдите скачанный файл (называется что-то вроде Git-2.xx.x-64-bit.exe)
5. Дважды щёлкните по нему мышкой
6. Если появится окно «Разрешить этому приложению вносить изменения?» — нажмите Да
7. Откроется окно установки. Нажимайте кнопку Next (Далее) внизу окна
8. Продолжайте нажимать Next до тех пор, пока не появится кнопка Install — нажмите её
9. Дождитесь завершения установки и нажмите Finish

Теперь установите VS Code:

1. Откройте браузер и перейдите по ссылке: code.visualstudio.com
2. Нажмите большую синюю кнопку Download for Windows
3. Откройте папку «Загрузки»
4. Найдите скачанный файл (называется что-то вроде VSCodeUserSetup-x64-1.xx.x.exe)
5. Дважды щёлкните по нему
6. Если появится окно «Разрешить этому приложению?» — нажмите Да
7. Нажимайте Next до кнопки Install, затем нажмите Install
8. Дождитесь завершения и нажмите Finish
9. VS Code запустится автоматически. Если нет — найдите его в меню «Пуск»

Если у вас Mac:

1. Нажмите клавиши Cmd + Пробел одновременно (появится строка поиска)
2. Напечатайте слово Terminal и нажмите Enter
3. Откроется чёрное окно — это терминал
4. Напечатайте команду git --version и нажмите Enter
5. Если появится окно «Установить инструменты разработчика?» — нажмите кнопку Установить
6. Дождитесь завершения установки

Теперь установите VS Code:

1. Откройте браузер и перейдите по ссылке: code.visualstudio.com
2. Нажмите большую кнопку Download for Mac
3. Откройте папку «Загрузки» (Downloads)
4. Найдите файл VSCode-darwin-universal.zip
5. Дважды щёлкните по нему — он распакуется в приложение
6. Перетащите появившийся значок Visual Studio Code в папку Программы (Applications)
7. Откройте папку «Программы» и дважды щёлкните на Visual Studio Code

Как проверить, что всё установилось:

После запуска VS Code вы увидите тёмное окно с надписью «Welcome». Это значит, что всё установлено правильно.

1.2 Создайте аккаунт на GitHub

Что такое GitHub: GitHub — это сайт, где хранятся ваши файлы и записи. Как облачное хранилище, но для проектов.

Как создать аккаунт:

1. Откройте браузер и перейдите на сайт github.com
2. В правом верхнем углу найдите кнопку Sign up и нажмите её
3. Введите ваш email (электронную почту)
4. Придумайте пароль (запишите его, чтобы не забыть!)
5. Придумайте имя пользователя (логин) — это будет ваш адрес на GitHub

Важно: Запомните или запишите ваш логин! Везде далее в инструкции, где написано ВАШ_ЛОГИН, вам нужно будет вписывать именно это имя.

6. Нажмите Create account
7. Пройдите проверку «Я не робот»
8. Откройте вашу почту и найдите письмо от GitHub
9. Нажмите на ссылку в письме для подтверждения

1.3 Сделайте Fork проекта

Что такое Fork: Fork — это ваша личная копия проекта. Все ваши записи будут храниться только у вас.

Как сделать Fork:

1. Убедитесь, что вы вошли в свой аккаунт на GitHub (в правом верхнем углу должен быть ваш аватар)
2. Откройте в браузере ссылку на оригинальный проект: github.com/smixs/agent-second-brain
3. В правом верхнем углу страницы найдите кнопку Fork (она выглядит как значок вилки)
4. Нажмите на неё
5. Откроется новая страница с заголовком «Create a new fork»
6. Ничего не меняйте и нажмите зелёную кнопку Create fork внизу
7. Подождите несколько секунд — вас перенаправит на вашу копию проекта

Теперь у вас есть своя копия по адресу: https://github.com/ВАШ_ЛОГИН/agent-second-brain

⚠️ ВАЖНО: Сделайте репозиторий приватным!

Ваш форк сейчас публичный — все ваши цели и записи будут видны всему интернету!

Как закрыть:

1. Откройте ваш репозиторий на GitHub
2. Settings → прокрутите вниз до Danger Zone
3. Нажмите Change visibility → выберите Private

Или создайте новый приватный репозиторий и скопируйте туда файлы.

Где посмотреть свой логин: Нажмите на свой аватар в правом верхнем углу GitHub — там будет написано ваше имя пользователя.

1.4 Клонируйте Fork на компьютер

Что значит «клонировать»: Это значит скачать проект с GitHub на ваш компьютер, чтобы вы могли редактировать файлы.

Шаг 1: Откройте VS Code

• На Windows: нажмите кнопку «Пуск» в левом нижнем углу экрана, напечатайте VS Code, нажмите Enter
• На Mac: нажмите Cmd + Пробел, напечатайте VS Code, нажмите Enter

Шаг 2: Откройте командную панель

• На Windows: нажмите одновременно три клавиши Ctrl + Shift + P
• На Mac: нажмите одновременно три клавиши Cmd + Shift + P

Сверху окна появится строка для ввода команд.

Шаг 3: Введите команду клонирования

1. В появившейся строке напечатайте Git: Clone и нажмите Enter
2. Появится строка «Provide repository URL» (введите адрес репозитория)
3. Напечатайте адрес вашего репозитория:

https://github.com/ВАШ_ЛОГИН/agent-second-brain.git

Важно: Замените ВАШ_ЛОГИН на ваш реальный логин GitHub! Например, если ваш логин ivan_petrov, введите: https://github.com/ivan_petrov/agent-second-brain.git

4. Нажмите Enter
5. Откроется окно выбора папки. Выберите папку «Документы» (Documents) и нажмите Select as Repository Destination
6. Дождитесь, пока проект скачается (появится индикатор загрузки)
7. Появится вопрос «Would you like to open?» — нажмите кнопку Open

Что произошло: VS Code скачал проект на ваш компьютер и открыл его. Слева вы увидите список папок и файлов проекта.

Если случайно закрыли VS Code:

1. Откройте VS Code снова
2. Нажмите меню File (Файл) в верхнем левом углу
3. Выберите Open Folder (Открыть папку)
4. Найдите папку agent-second-brain в папке «Документы»
5. Выберите её и нажмите Open (Открыть)

1.5 Заполните ваши цели

ЭТО САМЫЙ ВАЖНЫЙ ШАГ

Агент использует ваши цели, чтобы понимать, что для вас важно. Без целей он не сможет правильно расставлять приоритеты.

В левой части VS Code найдите папку vault, нажмите на стрелочку слева от неё, чтобы раскрыть. Внутри найдите папку goals. В ней лежат 4 файла:

• 0-vision-3y.md — видение на 3 года
• 1-yearly-YYYY.md — цели на год (переименуйте под текущий год, например 1-yearly-2026.md)
• 2-monthly.md — приоритеты на месяц
• 3-weekly.md — фокус на неделю

Как заполнить с помощью ChatGPT или Claude:

1. В левой панели VS Code нажмите на файл vault/goals/0-vision-3y.md, чтобы открыть его
2. Нажмите Ctrl+A (на Mac: Cmd+A), чтобы выделить весь текст
3. Нажмите Ctrl+C (на Mac: Cmd+C), чтобы скопировать
4. Откройте в браузере claude.ai или chat.openai.com
5. Вставьте скопированный текст (нажмите Ctrl+V или Cmd+V)
6. Добавьте после текста:

Это шаблон моего 3-летнего видения. Помоги мне его заполнить.

Правила:
1. Задавай вопросы ПО ОДНОМУ
2. Жди мой ответ, потом задавай следующий
3. Копай глубже — если отвечаю размыто, уточняй
4. В конце сформируй заполненный документ в том же формате

Начни с первого вопроса о карьере.

7. Отправьте сообщение и отвечайте на вопросы
8. Когда получите готовый заполненный документ — скопируйте его
9. Вернитесь в VS Code
10. В файле 0-vision-3y.md нажмите Ctrl+A (выделить всё), затем Ctrl+V (вставить)
11. Обязательно сохраните файл: нажмите Ctrl+S (на Mac: Cmd+S)

Важно: Если на вкладке файла рядом с названием горит белый кружочек — файл не сохранён! Обязательно нажмите Ctrl+S / Cmd+S.

Повторите для остальных файлов.

Промпты для них:

Для 1-yearly-YYYY.md:

Это шаблон годовых целей. На основе моего 3-летнего видения
помоги поставить цели на этот год. Задавай вопросы по одному.

Для 2-monthly.md:

Какие 3 главных приоритета на этот месяц? Задавай вопросы по одному.

Для 3-weekly.md:

Самое важное — секция "ONE Big Thing". Это одна главная задача на неделю.
Помоги определить её. Задавай вопросы.

Не забывайте сохранять каждый файл после изменений: Ctrl+S / Cmd+S

1.6 Настройте профиль

Откройте файл с информацией о себе. Есть два способа:

Быстрый способ:

1. Нажмите Ctrl+P (на Mac: Cmd+P)
2. В появившейся строке напечатайте about.md
3. Нажмите Enter

Или вручную: В левой панели VS Code раскройте папки по пути: vault → .claude → skills → dbrain-processor → references → about.md

В этом файле замените информацию на свою:

• Ваше имя
• Чем занимаетесь
• Основные проекты
• Приоритеты

Это поможет агенту понимать контекст ваших записей.

Сохраните файл: Ctrl+S / Cmd+S

1.7 Настройте систему под себя

Важно: Помимо about.md, в папке vault/.claude/skills/dbrain-processor/references/ есть ещё несколько файлов, которые нужно настроить под себя.

Какие файлы нужно обновить:

В той же папке лежат goals.md, links.md, rules.md и report-template.md — загляните и в них, там тоже есть подсказки, что заменить.

Может, у вас нет клиентов — вы работаете на производстве, в офисе, или фрилансер. Это нормально! Замените примеры на свои реалии: проекты, отделы, направления работы.

Самый простой способ настроить:

1. В левой панели VS Code найдите папку vault/.claude/skills/dbrain-processor/
2. Нажмите на неё правой кнопкой мыши
3. Выберите Reveal in Finder (Mac) или Open in File Explorer (Windows)
4. Заархивируйте эту папку в ZIP
5. Отправьте архив в ChatGPT или Claude с текстом:

Это настройки моего AI-ассистента.
Задавай мне вопросы по одному, чтобы заполнить все файлы под меня.
Когда закончим — верни мне обновлённый ZIP-архив.

6. Ответьте на все вопросы
7. Скачайте готовый архив
8. Разархивируйте и положите файлы обратно в ту же папку, заменив старые

Или вручную: Откройте каждый файл в папке references/ и замените примеры [Your ...] на свою информацию. В каждом файле есть подсказки.

1.8 Сохраните изменения в GitHub

Теперь нужно отправить все ваши изменения обратно на GitHub.

1. В левой части VS Code найдите третью иконку сверху — она выглядит как разветвление (три точки, соединённые линиями). Нажмите на неё.
2. Вы увидите раздел Source Control со списком изменённых файлов
3. Над списком файлов есть поле для ввода сообщения «Message»
4. Напечатайте в нём: Initial setup with my goals
5. Нажмите кнопку Commit (галочка сверху)
6. Если появится вопрос «Stage all changes?» — нажмите Yes
7. Затем нажмите кнопку Sync Changes или Publish Branch
8. Если спросит логин — введите ваш логин и пароль от GitHub

Готово! Ваш проект с вашими целями теперь сохранён в вашем репозитории на GitHub.

Контрольная точка: Часть 1 завершена

Часть 2: Получите ключи ⏱ 10 мин

Что нужно собрать: Вам понадобятся всего два секретных кода (токена) и одно число. Соберите их заранее и сохраните в надёжное место — блокнот, заметки или менеджер паролей. Скрипт установки спросит их у вас на сервере.

Это всё. Больше никаких ключей и сервисов — напоминания и задачи агент делает сам, без внешних таск-менеджеров.

2.1 Telegram Bot Token

1. Откройте приложение Telegram на телефоне или компьютере
2. В строке поиска напечатайте @BotFather
3. Откройте чат с BotFather (у него синяя галочка верификации)
4. Напечатайте и отправьте сообщение: /newbot
5. Бот спросит имя — напечатайте: My Second Brain
6. Бот спросит username — придумайте уникальное имя, которое заканчивается на bot Например: my_brain_777_bot или mysb_12345_bot
7. После создания бот пришлёт вам длинный код — это и есть токен
8. Скопируйте его сразу и сохраните! Он выглядит примерно так: 7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx

2.2 Ваш Telegram ID

1. В Telegram в строке поиска напечатайте @userinfobot
2. Откройте чат с этим ботом
3. Отправьте ему любое сообщение (например, «привет»)
4. Бот ответит информацией о вас. Найдите строку Id: и скопируйте число после неё
5. Это ваш Telegram ID, например: 123456789

Этот номер нужен, чтобы бот отвечал только вам — и знал, кому слать ежедневные отчёты.

2.3 Deepgram API Key

1. Откройте в браузере сайт console.deepgram.com
2. Нажмите Sign Up и зарегистрируйтесь (можно через Google)
3. После входа в левом меню найдите Settings (Настройки)
4. Выберите API Keys (Ключи API)
5. Нажмите кнопку Create API Key (Создать ключ)
6. Придумайте любое название (например, second-brain)
7. Важно: Ключ показывается только один раз! Скопируйте его сразу и сохраните.

Предупреждение: Если вы закроете окно, не скопировав ключ — он исчезнет навсегда и придётся создавать новый.

Контрольная точка: Часть 2 завершена

Сохраните все токены в надёжное место. Они понадобятся при настройке сервера.

Заодно решите, какая у вас таймзона (например, Europe/Moscow, Asia/Tashkent, Europe/Minsk) — скрипт установки спросит и её. По этой таймзоне агент будет присылать вечерний отчёт и срабатывать напоминания.

Часть 3: Настройка сервера ⏱ 30–50 мин

Хорошая новость: в версии 3.0 вам не нужно вручную устанавливать Python, Node.js и остальное. Всё это делает один скрипт. От вас — купить сервер, создать пользователя и запустить одну команду.

3.1 Купите VPS и подключитесь

Шаг 1: Купите сервер

1. Откройте сайт Contabo или OVH
2. Выберите самый дешёвый тариф (хватит с запасом)
3. Важно: При выборе операционной системы выберите Ubuntu 22.04 (или новее) — это база
4. Завершите покупку и оплату
5. На вашу почту придёт письмо с данными для входа: IP-адрес и пароль

Шаг 2: Подключитесь к серверу

На Windows:

1. Нажмите кнопку Пуск в левом нижнем углу
2. Напечатайте cmd и нажмите Enter
3. Откроется чёрное окно — это командная строка

На Mac:

1. Нажмите Cmd + Пробел
2. Напечатайте Terminal и нажмите Enter

В открывшемся окне напечатайте команду (замените ВАШ_IP_АДРЕС на IP из письма):

ssh root@ВАШ_IP_АДРЕС

Например: ssh root@185.123.45.67

Нажмите Enter.

Если спросит «Are you sure you want to continue?» — напечатайте yes и нажмите Enter.

Важно о пароле: Когда вы вводите пароль, в чёрном окне ничего не печатается — это нормально! Это не зависание. Просто введите пароль из письма и нажмите Enter. Буквы не видно в целях безопасности.

3.2 Создайте пользователя

Работать под пользователем root небезопасно — и скрипт установки от root запускаться откажется. Создайте обычного пользователя.

Напечатайте эти команды по одной, нажимая Enter после каждой:

adduser myuser

Система попросит придумать пароль — придумайте и запомните его. На остальные вопросы просто нажимайте Enter.

usermod -aG sudo myuser

su - myuser

Теперь вы работаете под пользователем myuser.

3.3 Запустите установку (одна команда)

Вся установка — одна команда. Скопируйте, вставьте в терминал и нажмите Enter (замените ВАШ_ЛОГИН на ваш логин GitHub):

curl -fsSL https://raw.githubusercontent.com/ВАШ_ЛОГИН/agent-second-brain/main/bootstrap.sh | bash

Дальше скрипт ведёт вас за руку. Под капотом работает цепочка из трёх скриптов — знать это не обязательно, но полезно понимать, что происходит на экране:

1. bootstrap.sh — та самая команда выше. Скачивает установщик и запускает его.
2. setup.sh — интерактивный опросник. Он:
   • установит всё необходимое сам: git, tmux, uv, Node.js, Claude Code
   • спросит ваш логин GitHub и скачает ваш форк в ~/projects/agent-second-brain
   • спросит токены по одному: Telegram Bot Token, ваш Telegram ID, Deepgram API Key (и сразу проверит, что формат правильный)
   • спросит вашу таймзону (например, Europe/Moscow; если просто нажать Enter — будет UTC)
   • предложит настроить доступ к GitHub для автосинхронизации записей (понадобится Personal Access Token — скрипт подскажет, где его взять)
   • попросит авторизовать Claude Code — про это следующий шаг, он важный
3. upgrade.sh — финальный аккорд, запускается автоматически. Ставит Python-зависимости, команду dbrain, сервисы автозапуска (systemd), запускает бота и проводит первый health check — самопроверку, что всё живо.

Отвечайте на вопросы скрипта и не пугайтесь бегущих строк — это нормально.

Если команда не сработала, выполните то же самое вручную:

cd ~
git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git
cd agent-second-brain
bash setup.sh

3.4 Авторизуйте Claude Code

В какой-то момент скрипт остановится и скажет: Claude Code is not logged in — нужно войти в ваш аккаунт Claude (тот самый, где подписка Pro или Max). Без этого мозг агента не запустится.

Скрипт попросит сделать вход в отдельном терминале. Вот как:

1. Не закрывая окно с установкой, откройте второе окно терминала (на Mac: Cmd+N в Терминале; на Windows: запустите cmd ещё раз)
2. Во втором окне подключитесь к серверу под вашим пользователем:

   ssh myuser@ВАШ_IP_АДРЕС
   

3. Запустите Claude:

   claude
   

4. Claude предложит войти и покажет ссылку. Скопируйте её и откройте в браузере на вашем компьютере
5. Войдите в аккаунт Anthropic (выбирайте вход через подписку Claude Pro/Max, не API) и подтвердите доступ
6. Вернитесь во второе окно терминала — Claude подтвердит вход. Выйдите из него (наберите /exit или нажмите Ctrl+C дважды)
7. Вернитесь в первое окно с установкой и нажмите Enter — скрипт проверит вход и продолжит сам

После этого установка дойдёт до конца и покажет рамку SETUP COMPLETE! — значит, бот уже запущен.

Контрольная точка: Часть 3 завершена

Попробуйте сразу: напишите боту «напомни через 10 минут размяться» — и проверьте, что через 10 минут он напишет вам сам. Это лучший тест, что всё работает.

Часть 4: Использование

Кнопки бота

┌──────────────────────────────────────────┐
│ [📊 Статус] [⚙️ Обработать] [❓ Помощь]  │
└──────────────────────────────────────────┘

А где кнопка «Запрос»? Она больше не нужна: любое ваше сообщение — это и есть запрос. Просто пишите или наговаривайте боту, что хотите.

Что можно отправлять

Голосовые — основной способ:

• «Надо написать Пете по проекту»
• «Идея: сделать лендинг с калькулятором»

Текст — ссылки, цитаты, быстрые мысли, вопросы агенту

Фото и картинки — скриншоты, фото досок: агент сохранит файл и сам прочитает, что на нём

Файлы, видео, кружочки — всё сохраняется в хранилище

Пересланные посты — из других чатов и каналов (агент запомнит и откуда)

Альбомы — несколько фото одним сообщением, агент обработает их вместе

Напоминания и расписания — главная суперсила

Агент сам управляет своим расписанием. Никаких внешних приложений — говорите обычным языком:

• «Напомни через час про звонок» → напишет вам через час
• «Напомни завтра в 15:00 про презентацию» → разовое напоминание
• «Каждое утро в 9 — сводка дня» → повторяющееся расписание
• «Каждый будний день в 18:30 проверяй мою папку входящих» → регулярная проверка (и молчит, если нового ничего нет)
• «Покажи мои напоминания» / «Удали напоминание про зарядку» → управление списком

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

Разговор с контекстом

Сессия агента постоянная — он помнит, о чём вы только что говорили:

Вы: что я писал про маркетинговый проект на той неделе?

Бот: находит и показывает записи

Вы: вторую идею оформи как заметку проекта с следующими шагами

Бот: создаёт заметку, связывает с другими

Вы: добавь туда ещё пункт про презентацию

Бот: обновляет ту же заметку

Полезные команды в чате:

Что происходит само, без вас

• Каждый вечер в 21:00 (по вашей таймзоне) агент обрабатывает все записи за день: классифицирует, раскладывает по папкам, обновляет карточки — и присылает отчёт в Telegram: что произошло, что сделано, что висит.
• Каждое утро в 08:00 проходит самопроверка (доктор): агент убеждается, что все системы живы, и чинит себя, если нужно.
• Память забывает, как настоящая. За память отвечает движок autograph — он использует кривую забывания Эббингауза: информация со временем «остывает», если вы к ней не возвращаетесь. Пять уровней — от «всегда в контексте» (текущие проекты, цели) до «почти забыто» (старый архив, который иногда случайно всплывает и даёт неожиданные идеи). Тот же движок следит за здоровьем хранилища: оценивает его по 100-балльной шкале, чинит сломанные ссылки, находит заметки-сироты и строит карты содержания (MOC). Движок живёт в отдельном репозитории — github.com/smixs/autograph — и работает на любом Obsidian-хранилище.

Вы не занимаетесь обслуживанием. Этим занимается агент.

Часть 5: Синхронизация

Ваши записи хранятся в папке vault/. Есть несколько способов их просматривать:

Способ 1: Obsidian (рекомендуем)

Что такое Obsidian: Это бесплатное приложение для просмотра заметок с красивыми связями между ними. Вы сможете видеть все свои мысли, заметки и цели в удобном интерфейсе.

На компьютере:

1. Откройте браузер и перейдите на obsidian.md
2. Скачайте приложение для вашей системы и установите его
3. Откройте Obsidian
4. Нажмите Open folder as vault
5. Найдите папку agent-second-brain (там, куда вы скачивали проект в Части 1)
6. Внутри неё выберите папку vault
7. Нажмите Open

Теперь вы видите все свои заметки, цели и мысли в красивом интерфейсе. Чтобы подтянуть свежие записи с сервера — откройте папку проекта в VS Code и нажмите Sync Changes (или выполните git pull).

На iPhone/iPad:

1. На компьютере переместите папку vault в iCloud Drive
2. На iPhone скачайте Obsidian из App Store
3. В приложении «Файлы» найдите папку vault в iCloud
4. В Obsidian нажмите «Open folder as vault» → выберите эту папку

На Android:

1. Установите GitJournal
2. Подключите ваш GitHub репозиторий
3. Все заметки будут синхронизироваться автоматически

Способ 2: GitHub напрямую

Все файлы хранятся в вашем репозитории на GitHub по адресу:

https://github.com/ВАШ_ЛОГИН/agent-second-brain

Вы можете:

• Просматривать заметки прямо на сайте
• Редактировать файлы через веб-интерфейс
• Скачивать обновления командой git pull

Способ 3: Просто спросите бота

Самый простой способ — спросить напрямую в Telegram:

• «Что я записал вчера?»
• «Покажи мои цели на неделю»
• «Какие напоминания у меня стоят?»
• «Найди заметку про [тема]»

Бот найдёт и покажет всё что нужно прямо в Telegram.

Обновление с прошлых версий

Уже пользуетесь Agent Second Brain первой или второй версии? Переход на v3.0 — это одна команда.

Подключитесь к серверу и выполните:

cd ~/projects/agent-second-brain
git pull
bash upgrade.sh

Если у вас проект лежит в другой папке (например, прямо в ~/agent-second-brain) — перейдите в неё: cd ~/agent-second-brain.

Скрипт сам:

• установит tmux и обновит зависимости
• подтянет свежий код
• мигрирует старые сервисы со старых имён d-brain-* на новые dbrain-* (старые отключит и удалит)
• установит команду dbrain
• запустит постоянную сессию и проведёт health check

Скрипт идемпотентный — это значит, что его безопасно запускать сколько угодно раз. Что-то пошло не так? Просто запустите bash upgrade.sh ещё раз.

Из .env можно удалить устаревшие строки от старых версий (например, ключи внешних таск-менеджеров) — v3.0 их игнорирует. А встроенный навык migrate-doctor умеет диагностировать и чинить поломанные обновления: запустите на сервере claude и напишите «проверь моё обновление».

Помощь

Команда dbrain — ваш пульт управления

После установки на сервере доступна команда dbrain — простая обёртка над всеми проверками:

dbrain status    # всё ли живо: бот, сторож, мозг
dbrain logs      # последние логи бота
dbrain restart   # перезапустить сервисы (мозг при этом выживает)
dbrain doctor    # полный осмотр с диагнозом
dbrain attach    # подключиться к живой сессии мозга и посмотреть, что он делает
dbrain clear     # очистить память текущего разговора (файлы не трогает)
dbrain login     # войти в Claude заново, если слетела авторизация

dbrain attach — это окно в голову агента. Вы увидите ту самую живую сессию Claude Code, в которую бот печатает ваши сообщения. Посмотрели — выходите комбинацией Ctrl+B, затем D (именно отпустив Ctrl+B перед D). Не закрывайте окно крестиком и не жмите Ctrl+C — сессия должна остаться жить.

Если что-то пошло не так

Самый простой способ решить проблему — запустить программу claude прямо в чёрном окне сервера.

1. Подключитесь к серверу (как в Части 3)
2. Перейдите в папку проекта:

   cd ~/projects/agent-second-brain
   

3. Запустите Claude:

   claude
   

4. Напишите ему:

   Я настраиваю бота, у меня возникла ошибка: [опишите что случилось]
   Что мне сделать?
   

Claude прочитает файлы проекта и поможет решить проблему.

Частые проблемы

Бот не отвечает в Telegram: Проверьте, работает ли он. Подключитесь к серверу и выполните:

dbrain status

Бот и сторож должны быть active, мозг — «жив». Если нет:

dbrain repair

Голосовые не распознаются: Проверьте, правильно ли вы ввели ключ Deepgram при настройке:

cat ~/projects/agent-second-brain/.env | grep DEEPGRAM

Поправить можно прямо в файле: nano ~/projects/agent-second-brain/.env, затем dbrain restart.

Claude не работает / агент молчит: Скорее всего, слетела авторизация. Войдите заново:

dbrain login

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

Хочется посмотреть логи:

dbrain logs
# или в реальном времени:
journalctl --user -u dbrain-bot -f

Telegram → Deepgram → постоянная сессия Claude Code (tmux) → Obsidian vault → отчёт в Telegram

# Статус всего
dbrain status
systemctl --user status 'dbrain-*'

# Логи бота
journalctl --user -u dbrain-bot -f          # в реальном времени
journalctl --user -u dbrain-bot -n 100      # последние 100 строк

# Перезапустить бота (сессия мозга выживает — KillMode=process)
systemctl --user restart dbrain-bot

# Остановить / запустить
systemctl --user stop dbrain-bot
systemctl --user start dbrain-bot

# Таймеры
systemctl --user list-timers

# Запустить обработку вручную
cd ~/projects/agent-second-brain
./scripts/process.sh

# Обновить код и сервисы (идемпотентно)
cd ~/projects/agent-second-brain
bash upgrade.sh

TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx
DEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
VAULT_PATH=./vault
ALLOWED_USER_IDS=[123456789]
TZ=Europe/Moscow

cd ~/projects/agent-second-brain
bash upgrade.sh

Мне нужно выполнить команду с sudo, но я не могу ввести пароль.

Пожалуйста, сделайте следующее:

1. Откройте новую вкладку терминала (Ctrl+Shift+T или Cmd+T)
2. Подключитесь к серверу:
   ssh ВАШ_ПОЛЬЗОВАТЕЛЬ@ВАШ_IP_АДРЕС

3. Выполните эту команду:
   sudo [КОМАНДА]

4. Введите пароль когда попросят
5. Вернитесь ко мне и скажите что готово

cd ~
mkdir -p projects
cd projects
git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git
cd agent-second-brain
uv sync

nano .env

TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx
DEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
VAULT_PATH=./vault
ALLOWED_USER_IDS=[123456789]
TZ=UTC

uv run python -m d_brain

bash upgrade.sh

git config user.name "My Bot"
git config user.email "your@email.com"

chmod 600 .git/config
git remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/agent-second-brain.git