Skip to content

An always-on second brain you talk to. Voice notes in Telegram → typed, linked knowledge in your Obsidian vault. Runs 24/7 on the Claude subscription you already have.

Обновление README.md: исправлены опечатки, улучшены формулировки и структура разделов, добавлены новые инструкции по настройке и использованию бота.

smixse5e565a3a44b
diff --git a/README.md b/README.md
index 8cc950b..dd2fb48 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
**Персональный AI-ассистент с долговременной памятью**
-Записывайте голосовые в Telegram - агент сам разберётся что с ними делать: создаст задачи, сохранит мысли, обновит прогресс по целям.
+Записывайте голосовые в Telegram — агент сам разберётся что с ними делать: создаст задачи, сохранит мысли, обновит прогресс по целям.
<p align="center">
<img width="350" alt="Telegram_27_December_2025_ALVR9dWM" src="https://github.com/user-attachments/assets/5f76a061-3b46-4857-b638-11783973c0ad" />
@@ -14,52 +14,59 @@
---
-## 📑 Оглавление
+## Главное перед началом
+
+| Параметр | Значение |
+|----------|----------|
+| **Время на настройку** | **2–3 часа тишины.** Не торопитесь — лучше один раз сделать правильно. |
+| **Стоимость** | ~$25/мес (Claude Pro $20 + VPS $5) |
+| **Приватность** | **Это ваш личный сервер. Никто, кроме вас, не имеет доступа к вашим мыслям и задачам.** |
+
+---
+
+## Оглавление
- [Зачем это нужно](#зачем-это-нужно)
- [Как это работает](#как-это-работает)
-- [Словарь терминов](#-словарь-терминов)
+- [Словарь терминов](#словарь-терминов)
- [Что понадобится](#что-понадобится)
-- **Часть 1: Подготовка на компьютере** ⏱ 30-50 мин
+- **Часть 1: Подготовка на компьютере** ⏱ 30–50 мин
- [1.1 Установите Git и VS Code](#11-установите-git-и-vs-code)
- [1.2 Создайте аккаунт на GitHub](#12-создайте-аккаунт-на-github)
- [1.3 Сделайте Fork проекта](#13-сделайте-fork-проекта)
- [1.4 Клонируйте Fork на компьютер](#14-клонируйте-fork-на-компьютер)
- [1.5 Заполните ваши цели](#15-заполните-ваши-цели)
- [1.6 Настройте профиль](#16-настройте-профиль)
- - [1.7 Настройте систему под себя](#17-настройте-систему-под-себя-важно)
+ - [1.7 Настройте систему под себя](#17-настройте-систему-под-себя)
- [1.8 Сохраните изменения в GitHub](#18-сохраните-изменения-в-github)
-- **Часть 2: Получите токены** ⏱ 15 мин
+- **Часть 2: Получите ключи** ⏱ 15 мин
- [2.1 Telegram Bot Token](#21-telegram-bot-token)
- [2.2 Ваш Telegram ID](#22-ваш-telegram-id)
- [2.3 Deepgram API Key](#23-deepgram-api-key)
- [2.4 Todoist API Token](#24-todoist-api-token)
-- **Часть 3: Настройка VPS** ⏱ 40-70 мин
+- **Часть 3: Настройка сервера** ⏱ 40–70 мин
- [3.1 Купите VPS и подключитесь](#31-купите-vps-и-подключитесь)
- [3.2 Создайте пользователя](#32-создайте-пользователя)
- [3.3 Установите всё необходимое](#33-установите-всё-необходимое)
-- **🚀 Запуск бота** (выберите один способ)
- - [Способ 1: Автоскрипт (рекомендуется)](#-способ-1-автоматический-скрипт-рекомендуется)
- - [Способ 2: Через Claude Code](#-способ-2-через-claude-code)
+ - [Запуск бота](#запуск-бота)
- [Часть 4: Использование](#часть-4-использование)
- [Часть 5: Синхронизация](#часть-5-синхронизация)
-- [FAQ](#faq)
-- [Дополнительно: MCP-серверы](#дополнительно-mcp-серверы)
+- [Помощь](#помощь)
---
## Зачем это нужно
-Это GTD-система (Getting Things Done) на стероидах. Один раз настроите — и у вас всегда под рукой понимание, что происходит в жизни.
+Это система управления задачами и мыслями «на стероидах». Один раз настроите — и у вас всегда под рукой понимание, что происходит в жизни.
**Кидайте туда вообще всё:**
-- Интересные посты из Telegram - пересылайте боту
-- Скриншоты - отправляйте
-- После встречи - надиктуйте голосом что было и какие решения
-- Эмоции, мысли, идеи - всё записывайте
-- Ссылки, цитаты, заметки - абсолютно всё
+- Интересные посты из Telegram — пересылайте боту
+- Скриншоты — отправляйте
+- После встречи — надиктуйте голосом что было и какие решения
+- Эмоции, мысли, идеи — всё записывайте
+- Ссылки, цитаты, заметки — абсолютно всё
-### ✨ Самая крутая кнопка — "Запрос"
+### Самая крутая кнопка — «Запрос»
Это **полноценный AI-агент**, которому можно сказать что угодно — и он сам разберётся что делать.
@@ -67,46 +74,41 @@
| Запрос | Что сделает агент |
|--------|-------------------|
-| "Найди ту идею про маркетинг, которую я записывал на прошлой неделе" | Найдёт в ваших заметках и покажет |
-| "Что я делал вчера?" | Даст отчёт по вчерашним записям и задачам |
-| "Перенеси все просроченные задачи на понедельник" | Найдёт в Todoist и перенесёт |
-| "Поставь повторяющуюся задачу: каждый день в 9 утра — зарядка" | Создаст в Todoist |
-| "Обнови мои недельные цели" | Откроет файл целей и поможет обновить |
-| "Какие задачи на этой неделе не сделаны?" | Покажет список из Todoist |
-| "Посоветуй, на чём сфокусироваться сегодня" | Проанализирует цели и задачи, даст совет |
+| «Найди ту идею про маркетинг, которую я записывал на прошлой неделе» | Найдёт в ваших заметках и покажет |
+| «Что я делал вчера?» | Даст отчёт по вчерашним записям и задачам |
+| «Перенеси все просроченные задачи на понедельник» | Найдёт в Todoist и перенесёт |
+| «Поставь повторяющуюся задачу: каждый день в 9 утра — зарядка» | Создаст в Todoist |
+| «Обнови мои недельные цели» | Откроет файл целей и поможет обновить |
+| «Какие задачи на этой неделе не сделаны?» | Покажет список из Todoist |
+| «Посоветуй, на чём сфокусироваться сегодня» | Проанализирует цели и задачи, даст совет |
Вы общаетесь с ним как с настоящим ассистентом. Он сам найдёт нужные файлы, обновит структуру, создаст задачи — всё автоматически.
---
-Чем больше вы делитесь информацией и чем лучше заполните цели и карточку о себе - тем лучше агент понимает ваш контекст и тем точнее расставляет приоритеты.
+Чем больше вы делитесь информацией и чем лучше заполните цели и карточку о себе — тем лучше агент понимает ваш контекст и тем точнее расставляет приоритеты.
-**Про Claude Code - не бойтесь названия.** Да, он называется "Code", но это универсальный AI-агент, который отлично помогает в жизни. У него чёткие инструкции как действовать с вашими записями - создавать задачи, сохранять мысли, следить за целями. Он просто работает.
+**Про Claude Code — не бойтесь названия.** Да, он называется «Code», но это универсальный AI-агент, который отлично помогает в жизни. У него чёткие инструкции как действовать с вашими записями — создавать задачи, сохранять мысли, следить за целями. Он просто работает.
---
-> ⚠️ **Если вы запутались**
+> **Если вы запутались на каком-то шаге**
>
-> Не переживайте! Скопируйте ссылку на этот репозиторий:
-> `https://github.com/smixs/agent-second-brain`
+> Не переживайте! Откройте [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) и напишите:
+> «Помоги разобраться с этой инструкцией, я застрял на шаге [номер шага]. Вот ссылка: https://github.com/ВАШ_ЛОГИН/agent-second-brain»
>
-> Отправьте её в [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) с вопросом:
-> "Помоги разобраться с этой инструкцией, я застрял на шаге [номер шага]"
->
-> Он прочитает README и поможет вам пошагово.
+> Он прочитает инструкцию и поможет вам пошагово.
---
## Как это работает
<p align="center">
-
<img width="600" alt="как это работает" src="https://github.com/user-attachments/assets/83a0e140-6fbd-4fa3-a799-2b8544663ab1">
-
-<p align="center">
+</p>
1. Вы отправляете голосовое/текст/фото в **Telegram**
-2. **Бот на VPS** сохраняет всё в файл
+2. **Бот на сервере** сохраняет всё в файл
3. **Claude Code** анализирует записи
4. Создаёт задачи в **Todoist**, сохраняет мысли в **Obsidian**
5. Отправляет отчёт обратно в **Telegram**
@@ -114,21 +116,19 @@
---
-## 📖 Словарь терминов
+## Словарь терминов
Если какие-то слова незнакомы — вот короткий словарь:
| Термин | Что это значит |
|--------|----------------|
| **VPS** | Удалённый мини-компьютер в интернете. Как ваш ПК, но работает 24/7 и находится в дата-центре |
-| **SSH** | Способ подключиться к VPS через терминал. Как удалённый рабочий стол, но текстом |
-| **Token** | Пароль для сервиса. Длинная строка букв и цифр, которую нельзя никому показывать |
+| **SSH** | Способ подключиться к VPS через чёрное окно с текстом (терминал). Как удалённый рабочий стол, но текстом |
+| **Token** | Секретный код для сервиса. Длинная строка букв и цифр, которую нельзя никому показывать |
| **Repo** | Репозиторий — папка проекта на GitHub. Там хранятся все файлы и история изменений |
| **.env** | Файл с секретами и настройками. Лежит только на сервере, никуда не публикуется |
-| **systemd** | Автозапуск на сервере. Следит чтобы бот работал, перезапускает если упал |
| **Fork** | Ваша личная копия проекта. Можете менять как хотите, оригинал не затронете |
| **Clone** | Скачать проект на компьютер. После этого можете открыть его в VS Code |
-| **MCP** | Model Context Protocol — способ подключить AI к внешним сервисам (Todoist, Gmail, Notion и др.) |
---
@@ -136,50 +136,83 @@
| Компонент | Зачем | Стоимость |
|-----------|-------|-----------|
-| **Claude Pro/Max** | AI-агент | $20/мес |
-| **VPS-сервер** | Бот работает 24/7 | ~$5/мес |
-| **GitHub** | Backup и синхронизация | бесплатно |
-| **Deepgram** | Транскрипция голосовых | бесплатно ($200 на старт) |
-| **Todoist** | Задачи в одном месте | бесплатно / $4/мес Pro |
+| **Claude Pro/Max** | AI-агент, который обрабатывает ваши записи | $20/мес |
+| **VPS-сервер** | Чтобы бот работал круглосуточно | ~$5/мес |
+| **GitHub** | Хранение и синхронизация всех ваших записей | бесплатно |
+| **Deepgram** | Превращение голосовых сообщений в текст | бесплатно ($200 на старт) |
+| **Todoist** | Хранение задач в одном месте | бесплатно / $4/мес Pro |
**Итого: ~$25/мес**
-### Где брать VPS
+### Где взять VPS
-Нужен сервер НЕ в РФ/РБ - там блокировка Claude по территории.
+Нужен сервер НЕ в России/Беларуси — там блокировка Claude по территории.
-- [Contabo](https://contabo.com) - $4.96/мес, работает с белорусскими картами
-- [OVH](https://ovhcloud.com) - $5/мес, тоже работает с белорусскими картами
+- [Contabo](https://contabo.com) — $4.96/мес, работает с белорусскими картами
+- [OVH](https://ovhcloud.com) — $5/мес, тоже работает с белорусскими картами
---
-# Часть 1: Подготовка на компьютере ⏱ 30-50 мин
+# Часть 1: Подготовка на компьютере ⏱ 30–50 мин
### 1.1 Установите Git и VS Code
**Что это такое:**
- **Git** — программа для скачивания и синхронизации проектов
-- **VS Code** — бесплатный редактор файлов (как Word, но для кода и настроек)
+- **VS Code** — бесплатный редактор файлов (как Word, но для настроек и кода)
+
+---
+
+**Если у вас Windows:**
+
+1. Откройте браузер и перейдите по ссылке: [git-scm.com/download/win](https://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](https://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 запустится автоматически. Если нет — найдите его в меню «Пуск»
-**Windows:**
-1. Скачайте [Git для Windows](https://git-scm.com/download/win)
-2. Запустите скачанный файл → нажимайте "Next" → "Install" → "Finish"
-3. Скачайте [VS Code](https://code.visualstudio.com/)
-4. Запустите скачанный файл → нажимайте "Next" → "Install" → "Finish"
-5. Запустите VS Code (найдите в меню Пуск или на рабочем столе)
+---
-**Mac:**
-1. Откройте Terminal (`Cmd + Пробел` → введите "Terminal" → Enter)
-2. Введите `git --version` и нажмите Enter
- - Если появится окно "Установить инструменты разработчика?" → нажмите "Установить"
-3. Скачайте [VS Code](https://code.visualstudio.com/)
-4. Откройте скачанный файл → перетащите VS Code в папку "Программы"
-5. Запустите VS Code из папки "Программы" или через Spotlight (`Cmd + Пробел` → "VS Code")
+**Если у вас Mac:**
-> 💡 **Как проверить что VS Code работает:**
-> После запуска вы увидите тёмное окно с надписью "Welcome". Это значит всё установлено правильно.
+1. Нажмите клавиши `Cmd + Пробел` одновременно (появится строка поиска)
+2. Напечатайте слово `Terminal` и нажмите Enter
+3. Откроется чёрное окно — это терминал
+4. Напечатайте команду `git --version` и нажмите Enter
+5. Если появится окно «Установить инструменты разработчика?» — нажмите кнопку **Установить**
+6. Дождитесь завершения установки
-<!-- TODO: Скриншот: VS Code с Welcome экраном -->
+Теперь установите VS Code:
+
+1. Откройте браузер и перейдите по ссылке: [code.visualstudio.com](https://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». Это значит, что всё установлено правильно.
<p align="center">
<img width="600" alt="Ghostty_27_December_2025_vPEZpgCt" src="https://github.com/user-attachments/assets/121bb943-ecf1-4827-93f4-ef59221bb49b" />
@@ -189,10 +222,23 @@
### 1.2 Создайте аккаунт на GitHub
-1. Зайдите на [github.com](https://github.com)
-2. Нажмите "Sign up"
-3. Введите email, придумайте пароль, выберите username
-4. Подтвердите email
+**Что такое GitHub:**
+GitHub — это сайт, где хранятся ваши файлы и записи. Как облачное хранилище, но для проектов.
+
+**Как создать аккаунт:**
+
+1. Откройте браузер и перейдите на сайт [github.com](https://github.com)
+2. В правом верхнем углу найдите кнопку **Sign up** и нажмите её
+3. Введите ваш email (электронную почту)
+4. Придумайте пароль (запишите его, чтобы не забыть!)
+5. Придумайте имя пользователя (логин) — это будет ваш адрес на GitHub
+
+> **Важно:** Запомните или запишите ваш логин! Везде далее в инструкции, где написано `ВАШ_ЛОГИН`, вам нужно будет вписывать именно это имя.
+
+6. Нажмите **Create account**
+7. Пройдите проверку «Я не робот»
+8. Откройте вашу почту и найдите письмо от GitHub
+9. Нажмите на ссылку в письме для подтверждения
<p align="center">
<img width="600" alt="Arc_27_December_2025_bAQJJGoP" src="https://github.com/user-attachments/assets/c09c12d8-23ee-4a2c-800e-aab564453ecd" />
@@ -202,102 +248,101 @@
### 1.3 Сделайте Fork проекта
-Fork - это ваша личная копия. Все записи будут храниться у вас.
+**Что такое Fork:**
+Fork — это ваша личная копия проекта. Все ваши записи будут храниться только у вас.
-1. Откройте: [github.com/smixs/agent-second-brain](https://github.com/smixs/agent-second-brain)
-2. Нажмите кнопку **Fork** (правый верхний угол)
-3. Выберите свой аккаунт
-4. Нажмите "Create fork"
+**Как сделать Fork:**
+
+1. Убедитесь, что вы вошли в свой аккаунт на GitHub (в правом верхнем углу должен быть ваш аватар)
+2. Откройте в браузере ссылку на оригинальный проект (попросите её у того, кто дал вам эту инструкцию)
+3. В правом верхнем углу страницы найдите кнопку **Fork** (она выглядит как значок вилки)
+4. Нажмите на неё
+5. Откроется новая страница с заголовком «Create a new fork»
+6. Ничего не меняйте и нажмите зелёную кнопку **Create fork** внизу
+7. Подождите несколько секунд — вас перенаправит на вашу копию проекта
<p align="center">
<img width="600" alt="Arc_27_December_2025_Uw5hbtiu" src="https://github.com/user-attachments/assets/c4cd5d39-f690-456b-892d-615c36460dba" />
</p>
-Теперь у вас есть своя копия: `https://github.com/ВАШ_ЛОГИН/agent-second-brain`
-
-> ⚠️ **ВАЖНО:** Здесь и далее `ВАШ_ЛОГИН` — это ваш логин на GitHub!
->
-> Например, если ваш логин `ivan_petrov`, то адрес будет:
-> `https://github.com/ivan_petrov/agent-second-brain`
->
-> Посмотреть свой логин можно в правом верхнем углу GitHub (там где ваш аватар).
+Теперь у вас есть своя копия по адресу: `https://github.com/ВАШ_ЛОГИН/agent-second-brain`
-<!-- TODO: Скриншот: GitHub с выделенным логином в правом верхнем углу -->
+> **Где посмотреть свой логин:**
+> Нажмите на свой аватар в правом верхнем углу GitHub — там будет написано ваше имя пользователя.
---
### 1.4 Клонируйте Fork на компьютер
+**Что значит «клонировать»:**
+Это значит скачать проект с GitHub на ваш компьютер, чтобы вы могли редактировать файлы.
+
**Шаг 1: Откройте VS Code**
-- Windows: найдите "VS Code" в меню Пуск
-- Mac: нажмите `Cmd + Пробел`, введите "VS Code", нажмите Enter
+- На Windows: нажмите кнопку «Пуск» в левом нижнем углу экрана, напечатайте `VS Code`, нажмите Enter
+- На Mac: нажмите `Cmd + Пробел`, напечатайте `VS Code`, нажмите Enter
**Шаг 2: Откройте командную панель**
-- Windows/Linux: нажмите `Ctrl + Shift + P`
-- Mac: нажмите `Cmd + Shift + P`
+- На Windows: нажмите одновременно три клавиши `Ctrl + Shift + P`
+- На Mac: нажмите одновременно три клавиши `Cmd + Shift + P`
-Сверху появится строка поиска.
+Сверху окна появится строка для ввода команд.
-**Шаг 3: Клонируйте проект**
-1. Введите `Git: Clone` и нажмите Enter
-2. Появится строка "Provide repository URL"
-3. Вставьте URL **вашего fork**:
+**Шаг 3: Введите команду клонирования**
-> ⚠️ **НЕ копируйте как есть!** Замените `ВАШ_ЛОГИН` на ваш логин GitHub.
+1. В появившейся строке напечатайте `Git: Clone` и нажмите Enter
+2. Появится строка «Provide repository URL» (введите адрес репозитория)
+3. Напечатайте адрес вашего репозитория:
- ```
- https://github.com/ВАШ_ЛОГИН/agent-second-brain.git
- ```
+```
+https://github.com/ВАШ_ЛОГИН/agent-second-brain.git
+```
- Например: `https://github.com/ivan_petrov/agent-second-brain.git`
+> **Важно:** Замените `ВАШ_ЛОГИН` на ваш реальный логин GitHub!
+> Например, если ваш логин `ivan_petrov`, введите:
+> `https://github.com/ivan_petrov/agent-second-brain.git`
4. Нажмите Enter
-5. Выберите папку куда сохранить (например, Documents или Документы)
-6. Нажмите "Select as Repository Destination"
-7. Дождитесь скачивания
-8. Появится вопрос "Would you like to open?" → нажмите **"Open"**
-
-> 💡 **Что произошло:**
-> VS Code скачал проект на ваш компьютер и открыл его. Слева вы увидите список папок и файлов проекта.
+5. Откроется окно выбора папки. Выберите папку «Документы» (Documents) и нажмите **Select as Repository Destination**
+6. Дождитесь, пока проект скачается (появится индикатор загрузки)
+7. Появится вопрос «Would you like to open?» — нажмите кнопку **Open**
-<!-- TODO: Скриншот: VS Code с открытым проектом и списком папок слева -->
+**Что произошло:**
+VS Code скачал проект на ваш компьютер и открыл его. Слева вы увидите список папок и файлов проекта.
<p align="center">
<img width="600" alt="Code_27_December_2025_mBvxd2PN" src="https://github.com/user-attachments/assets/cb65c71c-8229-4caa-b958-9c636f952c72" />
</p>
-> ⚠️ **Если случайно закрыли VS Code:**
+> **Если случайно закрыли VS Code:**
> 1. Откройте VS Code снова
-> 2. Нажмите `File` → `Open Folder` (или `Файл` → `Открыть папку`)
-> 3. Найдите папку `agent-second-brain` там, куда сохраняли (например, в Documents)
-> 4. Выберите её и нажмите "Open"
+> 2. Нажмите меню **File** (Файл) в верхнем левом углу
+> 3. Выберите **Open Folder** (Открыть папку)
+> 4. Найдите папку `agent-second-brain` в папке «Документы»
+> 5. Выберите её и нажмите **Open** (Открыть)
---
### 1.5 Заполните ваши цели
-> ⚠️ **ЭТО САМЫЙ ВАЖНЫЙ ШАГ**
+> **ЭТО САМЫЙ ВАЖНЫЙ ШАГ**
>
-> Бот использует ваши цели для приоритизации задач. Без целей он не понимает, что для вас важно.
+> Бот использует ваши цели, чтобы понимать, что для вас важно. Без целей он не сможет правильно расставлять приоритеты.
-В папке `vault/goals/` лежат 4 файла:
-- `0-vision-3y.md` - видение на 3 года
-- `1-yearly-2025.md` - цели на год
-- `2-monthly.md` - приоритеты на месяц
-- `3-weekly.md` - фокус на неделю
+В левой части VS Code найдите папку `vault`, нажмите на стрелочку слева от неё, чтобы раскрыть. Внутри найдите папку `goals`. В ней лежат 4 файла:
-**Заполняем с помощью ChatGPT или Claude:**
+- `0-vision-3y.md` — видение на 3 года
+- `1-yearly-2025.md` — цели на год
+- `2-monthly.md` — приоритеты на месяц
+- `3-weekly.md` — фокус на неделю
-1. В VS Code откройте файл `vault/goals/0-vision-3y.md`
+**Как заполнить с помощью ChatGPT или Claude:**
-<p align="center">
- <img width="600" alt="Code_27_December_2025_iTpZrkVd" src="https://github.com/user-attachments/assets/cd30d883-c430-4282-9fb6-3fc88edf1002" />
-</p>
-
-2. Выделите всё: `Ctrl+A` / `Cmd+A`
-3. Скопируйте: `Ctrl+C` / `Cmd+C`
-4. Откройте [claude.ai](https://claude.ai) или [chat.openai.com](https://chat.openai.com)
-5. Вставьте текст и добавьте промпт:
+1. В левой панели VS Code нажмите на файл `vault/goals/0-vision-3y.md`, чтобы открыть его
+2. Нажмите `Ctrl+A` (на Mac: `Cmd+A`), чтобы выделить весь текст
+3. Нажмите `Ctrl+C` (на Mac: `Cmd+C`), чтобы скопировать
+4. Откройте в браузере [claude.ai](https://claude.ai) или [chat.openai.com](https://chat.openai.com)
+5. Вставьте скопированный текст (нажмите `Ctrl+V` или `Cmd+V`)
+6. Добавьте после текста:
```
Это шаблон моего 3-летнего видения. Помоги мне его заполнить.
@@ -305,20 +350,27 @@ Fork - это ваша личная копия. Все записи будут
Правила:
1. Задавай вопросы ПО ОДНОМУ
2. Жди мой ответ, потом задавай следующий
-3. Копай глубже - если отвечаю размыто, уточняй
+3. Копай глубже — если отвечаю размыто, уточняй
4. В конце сформируй заполненный документ в том же формате
Начни с первого вопроса о карьере.
```
-6. Ответьте на все вопросы
-7. Когда получите результат - скопируйте его
-8. Вернитесь в VS Code
-9. Выделите всё в файле: `Ctrl+A` / `Cmd+A`
-10. Вставьте: `Ctrl+V` / `Cmd+V`
-11. **Сохраните:** `Ctrl+S` / `Cmd+S`
+7. Отправьте сообщение и отвечайте на вопросы
+8. Когда получите готовый заполненный документ — скопируйте его
+9. Вернитесь в VS Code
+10. В файле `0-vision-3y.md` нажмите `Ctrl+A` (выделить всё), затем `Ctrl+V` (вставить)
+11. **Обязательно сохраните файл:** нажмите `Ctrl+S` (на Mac: `Cmd+S`)
-Повторите для остальных файлов. Промпты для них:
+> **Важно:** Если на вкладке файла рядом с названием горит белый кружочек — файл не сохранён! Обязательно нажмите `Ctrl+S` / `Cmd+S`.
+
+<p align="center">
+ <img width="600" alt="Code_27_December_2025_iTpZrkVd" src="https://github.com/user-attachments/assets/cd30d883-c430-4282-9fb6-3fc88edf1002" />
+</p>
+
+**Повторите для остальных файлов.**
+
+Промпты для них:
**Для `1-yearly-2025.md`:**
```
@@ -333,61 +385,64 @@ Fork - это ваша личная копия. Все записи будут
**Для `3-weekly.md`:**
```
-Самое важное - секция "ONE Big Thing". Это одна главная задача на неделю.
+Самое важное — секция "ONE Big Thing". Это одна главная задача на неделю.
Помоги определить её. Задавай вопросы.
```
-> ⚠️ **Не забывайте сохранять:** `Ctrl+S` / `Cmd+S` после каждого файла!
+> **Не забывайте сохранять каждый файл после изменений:** `Ctrl+S` / `Cmd+S`
---
### 1.6 Настройте профиль
-Откройте файл с информацией о себе. В VS Code в левой панели откройте по пути:
-
-```
-vault → .claude → skills → dbrain-processor → references → about.md
-```
+Откройте файл с информацией о себе. Есть два способа:
-> 💡 **Быстрый способ:** Нажмите `Ctrl+P` / `Cmd+P` → введите `about.md` → нажмите Enter
+**Быстрый способ:**
+1. Нажмите `Ctrl+P` (на Mac: `Cmd+P`)
+2. В появившейся строке напечатайте `about.md`
+3. Нажмите Enter
-<!-- TODO: Скриншот: VS Code с открытым поиском файла и введённым about.md -->
+**Или вручную:**
+В левой панели VS Code раскройте папки по пути:
+`vault` → `.claude` → `skills` → `dbrain-processor` → `references` → `about.md`
-Замените информацию на свою:
-- Имя
+В этом файле замените информацию на свою:
+- Ваше имя
- Чем занимаетесь
- Основные проекты
- Приоритеты
Это поможет боту понимать контекст ваших записей.
+**Сохраните файл:** `Ctrl+S` / `Cmd+S`
+
---
-### 1.7 Настройте систему под себя (важно!)
+### 1.7 Настройте систему под себя
-> ⚠️ **ВНИМАНИЕ: Этот шаг критически важен!**
->
-> Помимо `about.md`, в папке `vault/.claude/skills/dbrain-processor/references/` есть ещё несколько файлов, которые нужно настроить под себя. Без этого бот не будет понимать ваш контекст.
+> **Важно:** Помимо `about.md`, в папке `vault/.claude/skills/dbrain-processor/references/` есть ещё несколько файлов, которые нужно настроить под себя.
-**Что нужно обновить:**
+**Какие файлы нужно обновить:**
| Файл | Что там настраивается |
|------|----------------------|
| `about.md` | Ваш профиль, цели, стиль работы |
-| `classification.md` | Категории задач, имена клиентов (если есть) |
+| `classification.md` | Категории задач, имена клиентов/проектов |
| `todoist.md` | Проекты в Todoist, приоритеты |
<p align="center">
<img width="350" alt="Antigravity_27_December_2025_POjAbCgi" src="https://github.com/user-attachments/assets/37a8c189-baef-4e90-8711-9e0c02855d72" />
</p>
-> 💡 **Может у вас нет клиентов** — вы работаете на производстве, в офисе, или фрилансер. Это нормально! Замените примеры на свои реалии: проекты, отделы, направления работы.
+> Может, у вас нет клиентов — вы работаете на производстве, в офисе, или фрилансер. Это нормально! Замените примеры на свои реалии: проекты, отделы, направления работы.
-**Самый простой способ настроить (рекомендуем):**
+**Самый простой способ настроить:**
-1. Скачайте папку `vault/.claude/skills/dbrain-processor/` целиком
-2. Заархивируйте её в ZIP
-3. Отправьте в [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) с промптом:
+1. В левой панели VS Code найдите папку `vault/.claude/skills/dbrain-processor/`
+2. Нажмите на неё правой кнопкой мыши
+3. Выберите **Reveal in Finder** (Mac) или **Open in File Explorer** (Windows)
+4. Заархивируйте эту папку в ZIP
+5. Отправьте архив в [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) с текстом:
```
Это настройки моего AI-ассистента.
@@ -395,61 +450,72 @@ vault → .claude → skills → dbrain-processor → references → about.md
Когда закончим — верни мне обновлённый ZIP-архив.
```
-4. Ответьте на все вопросы
-5. Скачайте готовый архив
-6. Разархивируйте и положите обратно с тем же названием папки
+6. Ответьте на все вопросы
+7. Скачайте готовый архив
+8. Разархивируйте и положите файлы обратно в ту же папку, заменив старые
**Или вручную:**
-
-Откройте каждый файл в папке `references/` и замените плейсхолдеры `[Your ...]` на свою информацию. В каждом файле есть подсказки в комментариях.
+Откройте каждый файл в папке `references/` и замените примеры `[Your ...]` на свою информацию. В каждом файле есть подсказки.
---
### 1.8 Сохраните изменения в GitHub
-В VS Code:
+Теперь нужно отправить все ваши изменения обратно на GitHub.
-1. В левой панели нажмите на иконку с веткой (Source Control)
-2. Вы увидите список изменённых файлов
-3. В поле "Message" напишите: `Initial setup with my goals`
-5. Нажмите кнопку "Commit"
-6. Нажмите ещё раз на эту же кнопку, но там будет написано "Sync Changes" или "Publish Branch"
+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
<p align="center">
<img width="400" alt="Antigravity_27_December_2025_2DT3p7IR" src="https://github.com/user-attachments/assets/f67958e9-8954-4d63-93d8-8cb7792abf3a" />
</p>
-
-Если спросит логин - введите ваш GitHub логин и пароль (или Personal Access Token).
-
-Ваш проект с вашими целями теперь в вашем репозитории.
+Готово! Ваш проект с вашими целями теперь сохранён в вашем репозитории на GitHub.
---
-### ✅ Контрольная точка: Часть 1 завершена
+### Контрольная точка: Часть 1 завершена
-| Что проверить | Ожидаемый результат | Если не работает |
-|---------------|---------------------|------------------|
-| У вас есть свой репозиторий | Откройте `github.com/ВАШ_ЛОГИН/agent-second-brain` — видите свои файлы | Вернитесь к шагу 1.3 и сделайте Fork |
-| Репозиторий приватный (опционально) | В настройках репо стоит Private | Settings → Change visibility → Private |
-| На компе открывается папка проекта | В VS Code слева видно папки `vault`, `src` и файлы | Вернитесь к шагу 1.4 и клонируйте заново |
-| Цели заполнены | Откройте `vault/goals/` — там ваши цели, не шаблон | Вернитесь к шагу 1.5 |
-| Изменения в GitHub | На github.com видны ваши коммиты | Вернитесь к шагу 1.8, нажмите Sync Changes |
+| Что проверить | Ожидаемый результат |
+|---------------|---------------------|
+| У вас есть свой репозиторий | Откройте `github.com/ВАШ_ЛОГИН/agent-second-brain` — видите свои файлы |
+| На компьютере есть папка проекта | В VS Code слева видны папки `vault`, `src` и файлы |
+| Цели заполнены | Откройте `vault/goals/` — там ваши цели, не шаблон |
+| Изменения в GitHub | На сайте github.com видны ваши изменения |
---
-## Часть 2: Получите токены ⏱ 15 мин
+# Часть 2: Получите ключи ⏱ 15 мин
+
+**Что нужно собрать:**
+Вам понадобятся 4 секретных кода (токена). Соберите их все заранее и сохраните в надёжное место — блокнот, заметки или менеджер паролей.
-Соберите все ключи заранее. Сохраните в надёжное место.
+| Токен | Откуда взять | Как выглядит |
+|-------|--------------|--------------|
+| Telegram Bot Token | @BotFather в Telegram | `7123456789:AAH...` |
+| Ваш Telegram ID | @userinfobot в Telegram | `123456789` |
+| Deepgram API Key | console.deepgram.com | Длинная строка |
+| Todoist API Token | todoist.com → Settings | 40 символов |
+
+---
### 2.1 Telegram Bot Token
-1. Откройте Telegram
-2. Найдите `@BotFather`
-3. Отправьте `/newbot` или откройте миниапп и создайте там новый бот
-4. Введите имя: `My Second Brain`
-5. Введите username: `my_brain_777_bot` (уникальный, заканчивается на `bot`)
-6. Скопируйте токен
+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`
<p align="center">
<img width="350" alt="Telegram_27_December_2025_QyxHhZBg" src="https://github.com/user-attachments/assets/712f661c-c63a-4c67-82b0-dc40c2e66317" />
@@ -459,18 +525,25 @@ vault → .claude → skills → dbrain-processor → references → about.md
### 2.2 Ваш Telegram ID
-1. Найдите `@userinfobot` в Telegram
-2. Отправьте любое сообщение
-3. Скопируйте свой ID: `123456789`
+1. В Telegram в строке поиска напечатайте `@userinfobot`
+2. Откройте чат с этим ботом
+3. Отправьте ему любое сообщение (например, «привет»)
+4. Бот ответит информацией о вас. Найдите строку **Id:** и скопируйте число после неё
+5. Это ваш Telegram ID, например: `123456789`
---
### 2.3 Deepgram API Key
-1. Зайдите на [console.deepgram.com](https://console.deepgram.com/)
-2. Зарегистрируйтесь
-3. Settings → API Keys → Create API Key
-4. Скопируйте ключ (показывается один раз!)
+1. Откройте в браузере сайт [console.deepgram.com](https://console.deepgram.com/)
+2. Нажмите **Sign Up** и зарегистрируйтесь (можно через Google)
+3. После входа в левом меню найдите **Settings** (Настройки)
+4. Выберите **API Keys** (Ключи API)
+5. Нажмите кнопку **Create API Key** (Создать ключ)
+6. Придумайте любое название (например, `second-brain`)
+7. **Важно:** Ключ показывается только один раз! Скопируйте его сразу и сохраните.
+
+> **Предупреждение:** Если вы закроете окно, не скопировав ключ — он исчезнет навсегда и придётся создавать новый.
<p align="center">
<img width="600" alt="Arc_27_December_2025_yTuxiFSA" src="https://github.com/user-attachments/assets/76d51155-7506-45f4-97b3-e4965496b266" />
@@ -480,9 +553,13 @@ vault → .claude → skills → dbrain-processor → references → about.md
### 2.4 Todoist API Token
-1. Зайдите на [todoist.com](https://todoist.com)
-2. Settings → Integrations → Developer
-3. Скопируйте API token
+1. Откройте в браузере сайт [todoist.com](https://todoist.com)
+2. Войдите в свой аккаунт или зарегистрируйтесь
+3. Нажмите на свой аватар в левом верхнем углу
+4. Выберите **Settings** (Настройки)
+5. В левом меню найдите **Integrations** (Интеграции)
+6. Прокрутите вниз до раздела **Developer**
+7. Скопируйте **API token**
<p align="center">
<img width="600" alt="Arc_27_December_2025_FlpSkZgR" src="https://github.com/user-attachments/assets/eb676e25-1633-44e4-b90e-6d066a3b46d2" />
@@ -490,26 +567,30 @@ vault → .claude → skills → dbrain-processor → references → about.md
---
-### ✅ Контрольная точка: Часть 2 завершена
+### Контрольная точка: Часть 2 завершена
-| Что проверить | Ожидаемый результат | Если не работает |
-|---------------|---------------------|------------------|
-| Telegram Bot Token | Строка вида `7123456789:AAH...` | Напишите `/newbot` в @BotFather |
-| Telegram ID | Число вида `123456789` | Напишите что угодно в @userinfobot |
-| Deepgram API Key | Длинная строка букв и цифр | Зайдите на console.deepgram.com → API Keys |
-| Todoist API Token | Строка из 40 символов | Todoist → Settings → Integrations → Developer |
+| Что проверить | Ожидаемый результат |
+|---------------|---------------------|
+| Telegram Bot Token | Строка вида `7123456789:AAH...` |
+| Ваш Telegram ID | Число вида `123456789` |
+| Deepgram API Key | Длинная строка букв и цифр |
+| Todoist API Token | Строка из 40 символов |
-> 💾 **Сохраните все токены** в надёжное место (заметки, менеджер паролей). Они понадобятся на VPS.
+> **Сохраните все токены** в надёжное место. Они понадобятся при настройке сервера.
---
-## Часть 3: Настройка VPS ⏱ 40-70 мин
+# Часть 3: Настройка сервера ⏱ 40–70 мин
### 3.1 Купите VPS и подключитесь
-1. Купите VPS на [Contabo](https://contabo.com/en/vps/) или [OVH](https://ovhcloud.com/en/vps/)
-2. Выберите Ubuntu 22.04
-3. Получите на почту IP-адрес и пароль
+**Шаг 1: Купите сервер**
+
+1. Откройте сайт [Contabo](https://contabo.com/en/vps/) или [OVH](https://ovhcloud.com/en/vps/)
+2. Выберите самый дешёвый тариф (хватит с запасом)
+3. **Важно:** При выборе операционной системы выберите **Ubuntu 22.04** — это база
+4. Завершите покупку и оплату
+5. На вашу почту придёт письмо с данными для входа: IP-адрес и пароль
<p align="center">
<img width="600" alt="Arc_27_December_2025_XNzzknIo" src="https://github.com/user-attachments/assets/9cd54275-199a-418c-9881-6be3aee471f5" />
@@ -527,12 +608,32 @@ vault → .claude → skills → dbrain-processor → references → about.md
<img width="600" alt="Spark Desktop_27_December_2025_sltZRiMZ" src="https://github.com/user-attachments/assets/7dceb211-90af-4d78-abb0-cec19a0abbdd" />
</p>
-4. Откройте терминал и подключитесь:
+**Шаг 2: Подключитесь к серверу**
+
+На Windows:
+1. Нажмите кнопку **Пуск** в левом нижнем углу
+2. Напечатайте `cmd` и нажмите Enter
+3. Откроется чёрное окно — это командная строка
+
+На Mac:
+1. Нажмите `Cmd + Пробел`
+2. Напечатайте `Terminal` и нажмите Enter
+
+В открывшемся окне напечатайте команду (замените `ВАШ_IP_АДРЕС` на IP из письма):
```bash
ssh root@ВАШ_IP_АДРЕС
```
+Например: `ssh [email protected]`
+
+Нажмите Enter.
+
+Если спросит «Are you sure you want to continue?» — напечатайте `yes` и нажмите Enter.
+
+> **Важно о пароле:**
+> **Когда вы вводите пароль, в чёрном окне ничего не печатается — это нормально!** Это не зависание. Просто введите пароль из письма и нажмите Enter. Буквы не видно в целях безопасности.
+
<p align="center">
<img width="600" alt="Ghostty_27_December_2025_OwCbt58A" src="https://github.com/user-attachments/assets/92b32f25-b6df-4d25-aac9-7733079cfac7" />
</p>
@@ -541,14 +642,26 @@ ssh root@ВАШ_IP_АДРЕС
### 3.2 Создайте пользователя
-Работать под root небезопасно:
+Работать под пользователем root небезопасно. Создайте обычного пользователя.
+
+Напечатайте эти команды **по одной**, нажимая Enter после каждой:
```bash
adduser myuser
+```
+
+Система попросит придумать пароль — придумайте и запомните его. На остальные вопросы просто нажимайте Enter.
+
+```bash
usermod -aG sudo myuser
+```
+
+```bash
su - myuser
```
+Теперь вы работаете под пользователем `myuser`.
+
<p align="center">
<img width="600" alt="Ghostty_27_December_2025_4iOcEzsO" src="https://github.com/user-attachments/assets/d8e0823a-18ae-4b07-a68b-ff555a18943f" />
</p>
@@ -557,99 +670,95 @@ su - myuser
### 3.3 Установите всё необходимое
+Скопируйте и вставьте эти команды **по одной** (после каждой нажимайте Enter и ждите завершения):
+
```bash
-# Обновление
sudo apt update && sudo apt upgrade -y
+```
-# Инструменты
+```bash
sudo apt install -y git curl wget build-essential
+```
-# Python 3.12
+```bash
sudo apt install -y software-properties-common
+```
+
+```bash
sudo add-apt-repository -y ppa:deadsnakes/ppa
+```
+
+```bash
sudo apt update
+```
+
+```bash
sudo apt install -y python3.12 python3.12-venv python3.12-dev
+```
-# uv (менеджер пакетов Python)
+```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+```bash
source ~/.bashrc
+```
-# Node.js 20
+```bash
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+```
+
+```bash
sudo apt install -y nodejs
+```
-# Claude CLI
+```bash
npm install -g @anthropic-ai/claude-code
+```
-# Авторизация
+```bash
claude auth login
```
-<p align="center">
- <img width="600" alt="Ghostty_27_December_2025_gAcpHg2c" src="https://github.com/user-attachments/assets/a4e2066d-fccb-4b6b-ba8d-8929c0709cc5" />
-</p>
----
-
-### ✅ Контрольная точка: Часть 3.3 завершена
-
-| Что проверить | Ожидаемый результат | Если не работает |
-|---------------|---------------------|------------------|
-| Подключение к VPS | `ssh user@IP` работает без ошибок | Проверьте IP и пароль из письма хостера |
-| Claude установлен | Команда `claude --version` показывает версию | Повторите `npm install -g @anthropic-ai/claude-code` |
-| Claude авторизован | `claude auth status` показывает `Logged in` | Выполните `claude auth login` заново |
-
----
-
-<h1 align="center">🛑 ВСЁ! СТОП!</h1>
+Последняя команда откроет ссылку для авторизации — следуйте инструкциям на экране.
<p align="center">
-<strong>Вы установили Claude Code и авторизовались.</strong><br>
-Дальше руками ничего делать не нужно — Claude Code сам всё настроит.
-Запустите Claude Code в папке проекта на VPS сервере через терминал по инструкции ниже - все остальное он настроит сам.
-</p>
-
-<p align="center">
-<a href="#-первый-запуск-бота">
-<img src="https://img.shields.io/badge/🚀_ПЕРЕЙТИ_К_ЗАПУСКУ-blue?style=for-the-badge&logoColor=white" alt="Перейти к запуску"/>
-</a>
+ <img width="600" alt="Ghostty_27_December_2025_gAcpHg2c" src="https://github.com/user-attachments/assets/a4e2066d-fccb-4b6b-ba8d-8929c0709cc5" />
</p>
---
-## 🚀 Первый запуск бота
+### Контрольная точка: Часть 3.3 завершена
-Выберите способ установки:
-
-| Способ | Для кого | Что делает |
-|--------|----------|------------|
-| **🟢 Автоматический (setup.sh)** | Новички | Скрипт всё спросит и настроит сам |
-| **🔵 Через Claude Code** | Продвинутые | Claude поможет с тонкой настройкой |
+| Что проверить | Как проверить |
+|---------------|---------------|
+| Подключение к серверу | Команда `ssh myuser@ВАШ_IP` работает без ошибок |
+| Claude установлен | Команда `claude --version` показывает номер версии |
+| Claude авторизован | Команда `claude auth status` показывает `Logged in` |
---
-### 🟢 Способ 1: Автоматический скрипт (рекомендуется)
+## Запуск бота
-**Одна команда + ответы на вопросы = работающий бот**
+**Вы установили Claude Code и авторизовались — отлично!**
-```bash
-# Подключитесь к VPS под обычным пользователем (не root!)
-# Затем выполните:
+Теперь просто вставьте эту команду и следуйте подсказкам на экране:
+```bash
curl -fsSL https://raw.githubusercontent.com/ВАШ_ЛОГИН/agent-second-brain/main/bootstrap.sh | bash
```
-> ⚠️ **Замените `ВАШ_ЛОГИН`** на ваш логин GitHub!
+> **Замените `ВАШ_ЛОГИН`** на ваш логин GitHub!
Скрипт сам:
-- ✅ Установит Python, Node.js, uv, Claude CLI
-- ✅ Клонирует ваш репозиторий
-- ✅ Спросит токены (Telegram, Deepgram, Todoist)
-- ✅ Создаст .env файл
-- ✅ Настроит автозапуск (systemd)
-- ✅ Запустит бота
-- ✅ Покажет статус или список проблем
+- Скачает ваш проект
+- Спросит у вас все токены (Telegram, Deepgram, Todoist)
+- Создаст файл с настройками
+- Настроит автозапуск
+- Запустит бота
+- Покажет статус
-**Если curl не работает**, скачайте вручную:
+**Если команда не сработала**, выполните вручную:
```bash
cd ~
@@ -660,197 +769,218 @@ bash setup.sh
---
-### 🔵 Способ 2: Через Claude Code
-
-Для тех, кто хочет больше контроля или нужна помощь с нестандартной настройкой.
-
-#### Действие 1: Скачайте проект
-
-```bash
-cd ~ && mkdir -p projects && cd projects && git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git && cd agent-second-brain
-```
+### Контрольная точка: Бот работает
-> ⚠️ **Замените `ВАШ_ЛОГИН`** на ваш логин GitHub!
+| Что проверить | Ожидаемый результат |
+|---------------|---------------------|
+| Бот отвечает на /start | В Telegram видны кнопки меню |
+| Голосовые распознаются | Бот отвечает текстом на голосовое сообщение |
+| Бот работает после перезагрузки | Перезагрузите сервер, бот снова отвечает |
-#### Действие 2: Запустите Claude Code
+---
-```bash
-claude
-```
+# Часть 4: Использование
-#### Действие 3: Скопируйте и вставьте этот промпт
+### Кнопки бота
```
-Помоги мне настроить этот проект на VPS https://github.com/smixs/agent-second-brain
-Я уже установил Claude Code и авторизовался.
-Мне нужно: настроить .env, запустить бота, настроить автозапуск.
-Веди пошагово, спрашивай токены когда нужно.
+┌─────────────────────────────────────────┐
+│ [📊 Статус] [⚙️ Обработать] [📅 Неделя] │
+│ [✨ Запрос] [❓ Помощь] │
+└─────────────────────────────────────────┘
```
-#### Действие 4: Отвечайте на вопросы Claude
-
-Claude Code сам:
-- Попросит у вас токены (Telegram, Deepgram, Todoist)
-- Создаст .env файл
-- Запустит бота
-- Настроит автозапуск
-- Проверит что всё работает
+| Кнопка | Что делает |
+|--------|------------|
+| 📊 Статус | Показывает сколько записей сегодня |
+| ⚙️ Обработать | Запускает обработку всех записей |
+| 📅 Неделя | Показывает недельный дайджест |
+| ✨ Запрос | Можно попросить что-то сделать (самая крутая!) |
+| ❓ Помощь | Показывает справку |
---
-### ✅ Контрольная точка: Бот работает
-
-| Что проверить | Ожидаемый результат | Если не работает |
-|---------------|---------------------|------------------|
-| Бот отвечает на /start | В Telegram видны кнопки меню | Проверьте TELEGRAM_BOT_TOKEN в .env |
-| Голосовые транскрибируются | Бот отвечает текстом на голосовое | Проверьте DEEPGRAM_API_KEY в .env |
-| Автозапуск настроен | `sudo systemctl status d-brain-bot` → `active (running)` | Claude поможет настроить systemd |
-| Бот работает после перезагрузки | Перезагрузите VPS, бот снова отвечает | `sudo systemctl enable d-brain-bot` |
+### Что можно отправлять
-**Готово!** Переходите к [Часть 5: Синхронизация](#часть-5-синхронизация).
+**Голосовые** — основной способ:
+- «Надо написать Пете по проекту»
+- «Идея: сделать лендинг с калькулятором»
----
+**Текст** — ссылки, цитаты, быстрые мысли
-## Что дальше после настройки?
+**Фото** — скриншоты, фото досок
-Когда Claude Code всё настроит и бот заработает:
+**Пересланные сообщения** — из других чатов
-**➡️ Перейдите к [Часть 5: Синхронизация](#часть-5-синхронизация)** — чтобы настроить Obsidian на компьютере и телефоне.
+---
-### Где смотреть свои записи?
+### Кнопка «✨ Запрос»
-| Способ | Описание |
-|--------|----------|
-| **Obsidian** | Красивый просмотр заметок с связями. Скачайте на [obsidian.md](https://obsidian.md) |
-| **GitHub** | Все файлы хранятся в вашем репозитории. Всегда можно зайти и посмотреть |
-| **Кнопка ✨ Запрос** | Спросите бота напрямую: "что я записал вчера?", "покажи мои цели" |
+1. Нажмите **✨ Запрос**
+2. Бот спросит «Что сделать?»
+3. Отправьте голосовое или текст
-> 💡 **Самое крутое** — кнопка **✨ Запрос** в боте. Вы всегда можете узнать текущий статус, внести изменения, спросить что угодно. Общайтесь с ботом напрямую как с ассистентом!
+Примеры:
+- «покажи задачи на сегодня»
+- «перенеси просроченные на понедельник»
+- «создай задачу: позвонить в банк»
---
-# ⚙️ Техническая документация для Claude Code
+# Часть 5: Синхронизация
-> ⚠️ **Этот раздел читает Claude Code, не вы!**
->
-> Ниже — детальные инструкции которые Claude Code использует для настройки VPS. Вам не нужно их читать или выполнять вручную.
->
-> **Для вас:** после настройки перейдите к [Часть 5: Синхронизация](#часть-5-синхронизация)
+Ваши записи хранятся в папке `vault/`. Есть несколько способов их просматривать:
----
+### Способ 1: Obsidian (рекомендуем)
-### ⚠️ Инструкция для Claude Code: команды с sudo
+**Что такое Obsidian:**
+Это бесплатное приложение для просмотра заметок с красивыми связями между ними. Вы сможете видеть все свои мысли, задачи и цели в удобном интерфейсе.
-**Claude Code не может выполнять команды с `sudo`** — они требуют ввода пароля.
+<p align="center">
+ <img width="1280" height="720" alt="image" src="https://github.com/user-attachments/assets/a5bb0499-1945-48b9-9cfe-512e75714d19" />
+</p>
-Когда нужно выполнить команду с sudo, попроси пользователя:
+**На компьютере:**
+1. Откройте браузер и перейдите на [obsidian.md](https://obsidian.md)
+2. Скачайте приложение для вашей системы и установите его
+3. Откройте Obsidian
+4. Нажмите **Open folder as vault**
+5. Найдите папку `agent-second-brain` (там, куда вы скачивали проект в Части 1)
+6. Внутри неё выберите папку `vault`
+7. Нажмите **Open**
-```
-Мне нужно выполнить команду с sudo, но я не могу ввести пароль.
+Теперь вы видите все свои заметки, цели и мысли в красивом интерфейсе.
-Пожалуйста, сделайте следующее:
+**На iPhone/iPad:**
+1. На компьютере переместите папку `vault` в iCloud Drive
+2. На iPhone скачайте Obsidian из App Store
+3. В приложении «Файлы» найдите папку `vault` в iCloud
+4. В Obsidian нажмите «Open folder as vault» → выберите эту папку
-1. Откройте новую вкладку терминала (Ctrl+Shift+T или Cmd+T)
-2. Подключитесь к серверу:
- ssh ВАШ_ПОЛЬЗОВАТЕЛЬ@ВАШ_IP_АДРЕС
+**На Android:**
+1. Установите [GitJournal](https://play.google.com/store/apps/details?id=io.gitjournal.gitjournal)
+2. Подключите ваш GitHub репозиторий
+3. Все заметки будут синхронизироваться автоматически
-3. Выполните эту команду:
- sudo [КОМАНДА]
+---
-4. Введите пароль когда попросят
-5. Вернитесь ко мне и скажите что готово
+### Способ 2: GitHub напрямую
+
+Все файлы хранятся в вашем репозитории на GitHub по адресу:
+```
+https://github.com/ВАШ_ЛОГИН/agent-second-brain
```
-Примеры команд которые требуют sudo:
-- `sudo systemctl ...` — управление сервисами
-- `sudo nano /etc/systemd/system/...` — создание сервисов
-- `sudo apt install ...` — установка пакетов
+Вы можете:
+- Просматривать заметки прямо на сайте
+- Редактировать файлы через веб-интерфейс
+- Скачивать обновления командой `git pull`
---
-### 3.4 Проверьте MCP Todoist
+### Способ 3: Кнопка «✨ Запрос»
-```bash
-npx -y @doist/todoist-ai --help
-```
+Самый простой способ — спросить бота напрямую:
+- «Что я записал вчера?»
+- «Покажи мои цели на неделю»
+- «Какие задачи на сегодня?»
+- «Найди заметку про [тема]»
-Если выполнилось без ошибок - всё ок. Подробнее: [github.com/Doist/todoist-ai](https://github.com/Doist/todoist-ai)
+Бот найдёт и покажет всё что нужно прямо в Telegram.
---
-### 3.5 Клонируйте ваш Fork
-
-> ⚠️ **ОБЯЗАТЕЛЬНО замените `ВАШ_ЛОГИН`** на ваш логин GitHub!
-> Иначе команда не сработает и вы увидите ошибку.
+# Помощь
-```bash
-cd ~
-mkdir -p projects
-cd projects
+### Если что-то пошло не так
-# ⚠️ ЗАМЕНИТЕ ВАШ_ЛОГИН на свой логин GitHub!
-# Например: git clone https://github.com/ivan_petrov/agent-second-brain.git
-git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git
+Самый простой способ решить проблему — запустить программу `claude` прямо в чёрном окне сервера.
-cd agent-second-brain
-uv sync
-```
+1. Подключитесь к серверу (как в Части 3)
+2. Перейдите в папку проекта:
+ ```bash
+ cd ~/agent-second-brain
+ ```
+3. Запустите Claude:
+ ```bash
+ claude
+ ```
+4. Напишите ему:
+ ```
+ Я настраиваю бота, у меня возникла ошибка: [опишите что случилось]
+ Что мне сделать?
+ ```
-<!-- TODO: Скриншот: терминал с успешным клонированием репозитория -->
+Claude прочитает файлы проекта и поможет решить проблему.
---
-### 3.6 Создайте файл .env
+### Частые проблемы
+**Бот не отвечает в Telegram:**
+Проверьте, работает ли он. Подключитесь к серверу и выполните:
```bash
-nano .env
+sudo systemctl status d-brain-bot
```
+Должно показать `active (running)`.
-Вставьте (замените на свои токены):
+**Голосовые не распознаются:**
+Проверьте, правильно ли вы ввели ключ Deepgram при настройке.
+**Claude не работает:**
+Проверьте авторизацию:
```bash
-TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx
-DEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-TODOIST_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-VAULT_PATH=./vault
-ALLOWED_USER_IDS=[123456789]
+claude auth status
+```
+Если нужно авторизоваться заново:
+```bash
+claude auth login
```
-
-> ⚠️ **ВАЖНО:** В `ALLOWED_USER_IDS` обязательно сохраняйте квадратные скобки `[ ]`!
->
-> Пример: `ALLOWED_USER_IDS=[123456789]` - правильно
-> `ALLOWED_USER_IDS=123456789` - неправильно
-
-Сохраните: `Ctrl+O` → `Enter` → `Ctrl+X`
---
-### 3.7 Тестовый запуск
+<details>
+<summary><strong>Технические детали (для продвинутых)</strong></summary>
+
+### Полезные команды
```bash
-uv run python -m d_brain
+# Посмотреть логи бота
+sudo journalctl -u d-brain-bot -f
+
+# Перезапустить бота
+sudo systemctl restart d-brain-bot
+
+# Остановить бота
+sudo systemctl stop d-brain-bot
+
+# Запустить бота
+sudo systemctl start d-brain-bot
```
-Откройте Telegram, найдите бота, отправьте `/start`.
+### MCP-серверы
-Если видите кнопки - работает. `Ctrl+C` для остановки.
+Эта система использует **MCP (Model Context Protocol)** — открытый стандарт от Anthropic для подключения AI к внешним сервисам. По умолчанию настроен Todoist, но вы можете подключить любой сервис, для которого есть MCP-сервер:
----
+| Сервис | MCP-сервер | Что можно делать |
+|--------|------------|------------------|
+| **Todoist** | [@doist/todoist-ai](https://github.com/Doist/todoist-ai) | Задачи, проекты, приоритеты *(уже настроен)* |
+| **Google Workspace** | [google_workspace_mcp](https://github.com/taylorwilsdon/google_workspace_mcp) | Gmail, Calendar, Drive |
+| **Notion** | [notion-mcp-server](https://github.com/makenotion/notion-mcp-server) | Страницы, базы данных |
+| **Things 3** | [things-mcp](https://github.com/hald/things-mcp) | Задачи на macOS/iOS |
+| **GitHub** | [github-mcp-server](https://github.com/github/github-mcp-server) | Issues, PR, репозитории |
-### 3.8 Настройте автозапуск
+Полный список: [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers)
+
+### Настройка systemd вручную
+
+Если автоматический скрипт не создал сервис:
```bash
sudo nano /etc/systemd/system/d-brain-bot.service
```
-> ⚠️ **ВАЖНО: Замените `myuser`** на имя пользователя, которое вы создали в шаге 3.2!
->
-> Если вы создали пользователя `ivan`, замените **все** `myuser` на `ivan`:
-> - `User=ivan`
-> - `WorkingDirectory=/home/ivan/projects/...`
-> - `ExecStart=/home/ivan/.local/bin/uv...`
->
-> В файле ниже `myuser` встречается **3 раза** — замените все!
+Вставьте (замените `myuser` на ваше имя пользователя):
```ini
[Unit]
@@ -860,7 +990,7 @@ After=network.target
[Service]
Type=simple
User=myuser
-WorkingDirectory=/home/myuser/projects/agent-second-brain
+WorkingDirectory=/home/myuser/agent-second-brain
ExecStart=/home/myuser/.local/bin/uv run python -m d_brain
Restart=always
RestartSec=10
@@ -869,271 +999,91 @@ RestartSec=10
WantedBy=multi-user.target
```
-<!-- TODO: Скриншот: nano редактор с заполненным конфигом (с реальным именем пользователя) -->
-
-Запустите:
+Сохраните (`Ctrl+O`, Enter, `Ctrl+X`) и выполните:
```bash
sudo systemctl daemon-reload
sudo systemctl enable d-brain-bot
sudo systemctl start d-brain-bot
-sudo systemctl status d-brain-bot
```
-Должно показать `active (running)`.
+</details>
---
-### 3.9 Настройте Git push
-
-```bash
-cd ~/projects/agent-second-brain
-git config user.name "My Bot"
-git config user.email "[email protected]"
-```
-
-Создайте токен на GitHub:
-1. GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
-2. Generate new token
-3. Scope: `repo`
-4. Скопируйте
-
-> ⚠️ **Замените `ТОКЕН` и `ВАШ_ЛОГИН`** в команде ниже!
->
-> - `ТОКЕН` — это Personal Access Token, который вы только что создали
-> - `ВАШ_ЛОГИН` — ваш логин на GitHub
+<details>
+<summary><strong>Инструкция для Claude Code (читает Claude, не вы)</strong></summary>
-```bash
-git remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/agent-second-brain.git
-```
+### Команды с sudo
-Например: `git remote set-url origin https://[email protected]/ivan_petrov/agent-second-brain.git`
+Claude Code не может выполнять команды с `sudo` — они требуют ввода пароля.
----
-
-### 3.10 Claude поможет донастроить
-
-> ✅ **ВАЖНЫЙ ШАГ**
->
-> Если вы успешно установили Claude Code и прошли авторизацию (`claude auth login`) —
-> дальше можно попросить Claude помочь с настройкой!
-
-Перейдите в папку проекта и запустите Claude:
-
-```bash
-cd ~/projects/agent-second-brain
-claude
-```
-
-Отправьте ему:
-
-```
-Помоги мне настроить проект по инструкции.
-Вот мой репозиторий: https://github.com/ВАШ_ЛОГИН/agent-second-brain
-
-Я уже сделал:
-- Клонировал репозиторий
-- Установил Claude Code
+Когда нужно выполнить команду с sudo, попроси пользователя:
-Что делать дальше?
```
+Мне нужно выполнить команду с sudo, но я не могу ввести пароль.
-> ⚠️ **Не забудьте заменить `ВАШ_ЛОГИН`** на ваш реальный логин GitHub!
-
-Claude прочитает файлы проекта, поймёт контекст и проведёт вас по остальным шагам.
-
-<!-- TODO: Скриншот: терминал с запущенным Claude Code -->
-
----
+Пожалуйста, сделайте следующее:
-## Часть 4: Использование
+1. Откройте новую вкладку терминала (Ctrl+Shift+T или Cmd+T)
+2. Подключитесь к серверу:
+ ssh ВАШ_ПОЛЬЗОВАТЕЛЬ@ВАШ_IP_АДРЕС
-### Кнопки бота
+3. Выполните эту команду:
+ sudo [КОМАНДА]
+4. Введите пароль когда попросят
+5. Вернитесь ко мне и скажите что готово
```
-┌─────────────────────────────────────────┐
-│ [📊 Статус] [⚙️ Обработать] [📅 Неделя] │
-│ [✨ Запрос] [❓ Помощь] │
-└─────────────────────────────────────────┘
-```
-
-| Кнопка | Что делает |
-|--------|------------|
-| 📊 Статус | Сколько записей сегодня |
-| ⚙️ Обработать | Запустить обработку |
-| 📅 Неделя | Недельный дайджест |
-| ✨ Запрос | Попросить что-то сделать |
-| ❓ Помощь | Справка |
-
----
-### Что можно отправлять
-
-**Голосовые** - основной способ:
-- "Надо написать Пете по проекту"
-- "Идея: сделать лендинг с калькулятором"
-
-**Текст** - ссылки, цитаты, быстрые мысли
-
-**Фото** - скриншоты, фото досок
-
-**Пересланные сообщения** - из других чатов
-
----
-
-### Кнопка ✨ Запрос
-
-1. Нажмите **✨ Запрос**
-2. Бот спросит "Что сделать?"
-3. Отправьте голосовое или текст
+### Ручные шаги настройки
-Примеры:
-- "покажи задачи на сегодня"
-- "перенеси просроченные на понедельник"
-- "создай задачу: позвонить в банк"
-
----
-
-## Часть 5: Синхронизация
-
-Ваши записи хранятся в папке `vault/`. Есть несколько способов их просматривать:
-
-### Способ 1: Obsidian (рекомендуем)
-
-[Obsidian](https://obsidian.md) — бесплатное приложение для просмотра заметок с красивыми связями между ними.
-
-<p align="center">
- <img width="1280" height="720" alt="image" src="https://github.com/user-attachments/assets/a5bb0499-1945-48b9-9cfe-512e75714d19" />
-</p>
-
-**На компьютере:**
-1. Скачайте [Obsidian](https://obsidian.md) и установите
-2. Откройте Obsidian
-3. Нажмите "Open folder as vault"
-4. Выберите папку `vault` из вашего проекта `agent-second-brain`
-
-Теперь вы видите все свои заметки, цели и мысли в красивом интерфейсе.
-
-**На iPhone/iPad:**
-1. На компьютере переместите папку `vault` в iCloud Drive
-2. На iPhone скачайте Obsidian из App Store
-3. В приложении "Файлы" найдите папку `vault` в iCloud
-4. Нажмите и удерживайте → "Сохранить на устройство" (чтобы работало офлайн)
-5. В Obsidian нажмите "Open folder as vault" → выберите эту папку
-
-**На Android:**
-1. Установите [GitJournal](https://play.google.com/store/apps/details?id=io.gitjournal.gitjournal)
-2. Подключите ваш GitHub репозиторий
-3. Все заметки будут синхронизироваться автоматически
-
-### Способ 2: GitHub напрямую
-
-Все файлы хранятся в вашем репозитории на GitHub:
-```
-https://github.com/ВАШ_ЛОГИН/agent-second-brain
+**Проверка MCP Todoist:**
+```bash
+npx -y @doist/todoist-ai --help
```
-Вы можете:
-- Просматривать заметки прямо на сайте
-- Редактировать файлы через веб-интерфейс
-- Скачивать обновления командой `git pull`
-
-### Способ 3: Кнопка ✨ Запрос
-
-Самый простой способ — спросить бота напрямую:
-- "Что я записал вчера?"
-- "Покажи мои цели на неделю"
-- "Какие задачи на сегодня?"
-- "Найди заметку про [тема]"
-
-Бот найдёт и покажет всё что нужно прямо в Telegram.
-
----
-
-# FAQ
-
-## Проблемы? Claude Code поможет
-
-Самое важное - установить Claude Code. После этого он сам донастроит всё остальное.
-
+**Клонирование репозитория:**
```bash
-cd ~/projects/agent-second-brain
-claude
+cd ~
+mkdir -p projects
+cd projects
+git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git
+cd agent-second-brain
+uv sync
```
-Напишите:
+**Создание .env:**
+```bash
+nano .env
```
-Помоги настроить проект по инструкции:
-https://github.com/smixs/agent-second-brain
-У меня проблема с [опишите]
+Содержимое:
+```bash
+TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx
+DEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+TODOIST_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+VAULT_PATH=./vault
+ALLOWED_USER_IDS=[123456789]
```
-Он прочитает README, увидит файлы и поможет.
+> В `ALLOWED_USER_IDS` обязательно сохраняйте квадратные скобки!
----
-
-## Технические проблемы
-
-**Бот не отвечает:**
+**Тестовый запуск:**
```bash
-sudo systemctl status d-brain-bot
-sudo journalctl -u d-brain-bot -n 50
+uv run python -m d_brain
```
-**Claude не работает:**
+**Настройка Git push:**
```bash
-claude auth status
-claude auth login
+git config user.name "My Bot"
+git config user.email "[email protected]"
```
-**Голосовые не транскрибируются:**
-- Проверьте DEEPGRAM_API_KEY в .env
-
----
-
-## Полезные команды
+Создайте Personal Access Token на GitHub: Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token (scope: repo)
```bash
-# Логи
-sudo journalctl -u d-brain-bot -f
-
-# Перезапуск
-sudo systemctl restart d-brain-bot
-
-# Статус таймеров
-sudo systemctl list-timers
+git remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/agent-second-brain.git
```
----
-
-# Дополнительно: MCP-серверы
-
-> 💡 **Этот раздел для продвинутых пользователей.** Если вы только начинаете — пропустите его.
-
-### 🔌 Универсальная система через MCP
-
-Эта система использует **MCP (Model Context Protocol)** — открытый стандарт от Anthropic для подключения AI к внешним сервисам. По умолчанию здесь настроен Todoist, но вы можете подключить **любой сервис**, для которого есть MCP-сервер:
-
-| Сервис | MCP-сервер | Что можно делать |
-|--------|------------|------------------|
-| **Todoist** | [@doist/todoist-ai](https://github.com/Doist/todoist-ai) | Задачи, проекты, приоритеты *(уже настроен)* |
-| **Google Workspace** | [google_workspace_mcp](https://github.com/taylorwilsdon/google_workspace_mcp) | Gmail, Calendar, Drive, Docs, Sheets |
-| **Notion** | [notion-mcp-server](https://github.com/makenotion/notion-mcp-server) | Страницы, базы данных, блоки |
-| **Things 3** | [things-mcp](https://github.com/hald/things-mcp) | Задачи на macOS/iOS |
-| **Obsidian** | [mcp-obsidian](https://github.com/MarkusPfundstein/mcp-obsidian) | Заметки, поиск, редактирование |
-| **GitHub** | [github-mcp-server](https://github.com/github/github-mcp-server) | Issues, PR, репозитории |
-| **Slack** | [slack-mcp](https://github.com/modelcontextprotocol/servers/tree/main/src/slack) | Сообщения, каналы |
-
-> 💡 **Не используете Todoist?** Замените на Things, TickTick или любой другой сервис. Полный список MCP-серверов: [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers)
-
----
-
-# Поддержка
-
-- Вопросы: [@aimastersme](https://t.me/aimastersme)
-- Баги: [GitHub Issues](https://github.com/smixs/agent-second-brain/issues)
-
----
-
-*Made with 🧠 by [@serge shima](https://t.me/shimaoz)*
+</details>