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.

feat(install): add one-command installer for Mac/WSL

smixs1d20a4ab8573
diff --git a/README.md b/README.md
index 1f383ed..ffd0896 100644
--- a/README.md
+++ b/README.md
@@ -1,1123 +1,118 @@
# Agent Second Brain
-<p align="center">
- <img alt="telegram-cloud-photo-size-2-5332708313742904084-y" src="https://github.com/user-attachments/assets/ea384e65-436b-48a1-a4e1-2b003cafcdbf" />
-</p>
+Personal AI assistant with memory. Voice messages in Telegram get transcribed, saved to Obsidian, and create tasks in Todoist.
-**Персональный AI-ассистент с долговременной памятью**
-
-Записывайте голосовые в 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" />
-</p>
-
----
-
-## Главное перед началом
-
-| Параметр | Значение |
-|----------|----------|
-| **Время на настройку** | **2–3 часа тишины.** Не торопитесь — лучше один раз сделать правильно. |
-| **Стоимость** | ~$25/мес (Claude Pro $20 + VPS $5) |
-| **Приватность** | **Это ваш личный сервер. Никто, кроме вас, не имеет доступа к вашим мыслям и задачам.** |
-
----
-
-## Оглавление
-
-- [Зачем это нужно](#зачем-это-нужно)
-- [Как это работает](#как-это-работает)
-- [Словарь терминов](#словарь-терминов)
-- [Что понадобится](#что-понадобится)
-- **Часть 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.8 Сохраните изменения в GitHub](#18-сохраните-изменения-в-github)
-- **Часть 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: Настройка сервера** ⏱ 40–70 мин
- - [3.1 Купите VPS и подключитесь](#31-купите-vps-и-подключитесь)
- - [3.2 Создайте пользователя](#32-создайте-пользователя)
- - [3.3 Установите всё необходимое](#33-установите-всё-необходимое)
- - [Запуск бота](#запуск-бота)
-- [Часть 4: Использование](#часть-4-использование)
-- [Часть 5: Синхронизация](#часть-5-синхронизация)
-- [Помощь](#помощь)
-
----
-
-## Зачем это нужно
-
-Это система управления задачами и мыслями «на стероидах». Один раз настроите — и у вас всегда под рукой понимание, что происходит в жизни.
-
-**Кидайте туда вообще всё:**
-- Интересные посты из Telegram — пересылайте боту
-- Скриншоты — отправляйте
-- После встречи — надиктуйте голосом что было и какие решения
-- Эмоции, мысли, идеи — всё записывайте
-- Ссылки, цитаты, заметки — абсолютно всё
-
-### Самая крутая кнопка — «Запрос»
-
-Это **полноценный AI-агент**, которому можно сказать что угодно — и он сам разберётся что делать.
-
-**Примеры того, что можно попросить:**
-
-| Запрос | Что сделает агент |
-|--------|-------------------|
-| «Найди ту идею про маркетинг, которую я записывал на прошлой неделе» | Найдёт в ваших заметках и покажет |
-| «Что я делал вчера?» | Даст отчёт по вчерашним записям и задачам |
-| «Перенеси все просроченные задачи на понедельник» | Найдёт в Todoist и перенесёт |
-| «Поставь повторяющуюся задачу: каждый день в 9 утра — зарядка» | Создаст в Todoist |
-| «Обнови мои недельные цели» | Откроет файл целей и поможет обновить |
-| «Какие задачи на этой неделе не сделаны?» | Покажет список из Todoist |
-| «Посоветуй, на чём сфокусироваться сегодня» | Проанализирует цели и задачи, даст совет |
-
-Вы общаетесь с ним как с настоящим ассистентом. Он сам найдёт нужные файлы, обновит структуру, создаст задачи — всё автоматически.
-
----
-
-Чем больше вы делитесь информацией и чем лучше заполните цели и карточку о себе — тем лучше агент понимает ваш контекст и тем точнее расставляет приоритеты.
-
-**Про Claude Code — не бойтесь названия.** Да, он называется «Code», но это универсальный AI-агент, который отлично помогает в жизни. У него чёткие инструкции как действовать с вашими записями — создавать задачи, сохранять мысли, следить за целями. Он просто работает.
-
----
-
-> **Если вы запутались на каком-то шаге**
->
-> Не переживайте! Откройте [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) и напишите:
-> «Помоги разобраться с этой инструкцией, я застрял на шаге [номер шага]. Вот ссылка: https://github.com/smixs/agent-second-brain»
->
-> Он прочитает инструкцию и поможет вам пошагово.
-
----
-
-## Как это работает
-
-<p align="center">
-<img width="600" alt="как это работает" src="https://github.com/user-attachments/assets/83a0e140-6fbd-4fa3-a799-2b8544663ab1">
-</p>
-
-1. Вы отправляете голосовое/текст/фото в **Telegram**
-2. **Бот на сервере** сохраняет всё в файл
-3. **Claude Code** анализирует записи
-4. Создаёт задачи в **Todoist**, сохраняет мысли в **Obsidian**
-5. Отправляет отчёт обратно в **Telegram**
-6. Всё синхронизируется в **GitHub**
-
----
-
-## Словарь терминов
-
-Если какие-то слова незнакомы — вот короткий словарь:
-
-| Термин | Что это значит |
-|--------|----------------|
-| **VPS** | Удалённый мини-компьютер в интернете. Как ваш ПК, но работает 24/7 и находится в дата-центре |
-| **SSH** | Способ подключиться к VPS через чёрное окно с текстом (терминал). Как удалённый рабочий стол, но текстом |
-| **Token** | Секретный код для сервиса. Длинная строка букв и цифр, которую нельзя никому показывать |
-| **Repo** | Репозиторий — папка проекта на GitHub. Там хранятся все файлы и история изменений |
-| **.env** | Файл с секретами и настройками. Лежит только на сервере, никуда не публикуется |
-| **Fork** | Ваша личная копия проекта. Можете менять как хотите, оригинал не затронете |
-| **Clone** | Скачать проект на компьютер. После этого можете открыть его в VS Code |
-
----
-
-## Что понадобится
-
-| Компонент | Зачем | Стоимость |
-|-----------|-------|-----------|
-| **Claude Pro/Max** | AI-агент, который обрабатывает ваши записи | $20/мес |
-| **VPS-сервер** | Чтобы бот работал круглосуточно | ~$5/мес |
-| **GitHub** | Хранение и синхронизация всех ваших записей | бесплатно |
-| **Deepgram** | Превращение голосовых сообщений в текст | бесплатно ($200 на старт) |
-| **Todoist** | Хранение задач в одном месте | бесплатно / $4/мес Pro |
-
-**Итого: ~$25/мес**
-
-### Где взять VPS
-
-Нужен сервер НЕ в России/Беларуси — там блокировка Claude по территории.
-
-- [Contabo](https://contabo.com) — $4.96/мес, работает с белорусскими картами
-- [OVH](https://ovhcloud.com) — $5/мес, тоже работает с белорусскими картами
-
----
-
-# Часть 1: Подготовка на компьютере ⏱ 30–50 мин
-
-### 1.1 Установите Git и VS Code
-
-**Что это такое:**
-- **Git** — программа для скачивания и синхронизации проектов
-- **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 запустится автоматически. Если нет — найдите его в меню «Пуск»
-
----
-
-**Если у вас Mac:**
-
-1. Нажмите клавиши `Cmd + Пробел` одновременно (появится строка поиска)
-2. Напечатайте слово `Terminal` и нажмите Enter
-3. Откроется чёрное окно — это терминал
-4. Напечатайте команду `git --version` и нажмите Enter
-5. Если появится окно «Установить инструменты разработчика?» — нажмите кнопку **Установить**
-6. Дождитесь завершения установки
-
-Теперь установите 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" />
-</p>
-
----
-
-### 1.2 Создайте аккаунт на GitHub
-
-**Что такое 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" />
-</p>
-
----
-
-### 1.3 Сделайте Fork проекта
-
-**Что такое Fork:**
-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 — там будет написано ваше имя пользователя.
-
----
-
-> ## 🔐🔐🔐 ВАЖНО: СДЕЛАЙТЕ РЕПОЗИТОРИЙ ПРИВАТНЫМ! 🔐🔐🔐
->
-> **⚠️ ВНИМАНИЕ: ВАШИ МЫСЛИ, ЦЕЛИ И ЗАПИСИ БУДУТ ВИДНЫ ВСЕМ В ИНТЕРНЕТЕ!**
->
-> По умолчанию форк — публичный. Это значит, что **любой человек** может прочитать ваши личные записи, цели и мысли. **Сделайте репозиторий приватным СРАЗУ после форка!**
->
-> ---
->
-> ### 📋 Шаги через веб-интерфейс GitHub:
->
-> 1. Перейдите в **Settings** (Настройки) вашего форка
-> 2. Прокрутите вниз до раздела **"Danger Zone"** (красная зона)
-> 3. Нажмите **"Leave fork network"** (Выйти из fork-сети) и подтвердите
-> 4. **Обновите страницу** (F5)
-> 5. Вернитесь в **"Danger Zone"**
-> 6. Нажмите **"Change visibility"** → выберите **"Private"** (Приватный)
-> 7. Подтвердите действие
->
-> ---
->
-> ✅ **После этого:** только вы сможете видеть содержимое репозитория.
->
-> ❌ **Если не сделать:** ваши голосовые расшифровки, личные цели, мысли и идеи будут доступны в Google и любому желающему.
-
----
-
-### 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 скачал проект на ваш компьютер и открыл его. Слева вы увидите список папок и файлов проекта.
-
-<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:**
-> 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-2025.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](https://claude.ai) или [chat.openai.com](https://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`.
-
-<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`:**
-```
-Это шаблон годовых целей. На основе моего 3-летнего видения
-помоги поставить цели на 2025 год. Задавай вопросы по одному.
-```
-
-**Для `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/` есть ещё несколько файлов, которые нужно настроить под себя.
-
-**Какие файлы нужно обновить:**
-
-| Файл | Что там настраивается |
-|------|----------------------|
-| `about.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. В левой панели 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-ассистента.
-Задавай мне вопросы по одному, чтобы заполнить все файлы под меня.
-Когда закончим — верни мне обновлённый 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
-
-<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.
-
----
-
-### Контрольная точка: Часть 1 завершена
-
-| Что проверить | Ожидаемый результат |
-|---------------|---------------------|
-| У вас есть свой репозиторий | Откройте `github.com/ВАШ_ЛОГИН/agent-second-brain` — видите свои файлы |
-| На компьютере есть папка проекта | В VS Code слева видны папки `vault`, `src` и файлы |
-| Цели заполнены | Откройте `vault/goals/` — там ваши цели, не шаблон |
-| Изменения в GitHub | На сайте github.com видны ваши изменения |
-
----
-
-# Часть 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. Откройте чат с 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" />
-</p>
-
----
-
-### 2.2 Ваш Telegram ID
-
-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. Нажмите **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" />
-</p>
-
----
-
-### 2.4 Todoist 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" />
-</p>
-
----
-
-### Контрольная точка: Часть 2 завершена
-
-| Что проверить | Ожидаемый результат |
-|---------------|---------------------|
-| Telegram Bot Token | Строка вида `7123456789:AAH...` |
-| Ваш Telegram ID | Число вида `123456789` |
-| Deepgram API Key | Длинная строка букв и цифр |
-| Todoist API Token | Строка из 40 символов |
-
-> **Сохраните все токены** в надёжное место. Они понадобятся при настройке сервера.
-
----
-
-# Часть 3: Настройка сервера ⏱ 40–70 мин
-
-### 3.1 Купите VPS и подключитесь
-
-**Шаг 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" />
-</p>
-
-<p align="center">
- <img width="600" alt="Arc_27_December_2025_a5D7KnnM" src="https://github.com/user-attachments/assets/78d1343d-94f8-47eb-be77-4eeda1ae76ff" />
-</p>
-
-<p align="center">
- <img width="600" alt="Arc_27_December_2025_tvjyMe08" src="https://github.com/user-attachments/assets/a35a8176-31fa-4417-9603-ed83b741cece" />
-</p>
-
-<p align="center">
- <img width="600" alt="Spark Desktop_27_December_2025_sltZRiMZ" src="https://github.com/user-attachments/assets/7dceb211-90af-4d78-abb0-cec19a0abbdd" />
-</p>
-
-**Шаг 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>
-
----
-
-### 3.2 Создайте пользователя
-
-Работать под пользователем 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>
-
----
-
-### 3.3 Установите всё необходимое
-
-Скопируйте и вставьте эти команды **по одной** (после каждой нажимайте Enter и ждите завершения):
-
-```bash
-sudo apt update && sudo apt upgrade -y
-```
-
-```bash
-sudo apt install -y git curl wget build-essential
-```
-
-```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
-```
-
-```bash
-curl -LsSf https://astral.sh/uv/install.sh | sh
-```
-
-```bash
-source ~/.bashrc
-```
-
-```bash
-curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
-```
-
-```bash
-sudo apt install -y nodejs
-```
-
-```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 завершена
-
-| Что проверить | Как проверить |
-|---------------|---------------|
-| Подключение к серверу | Команда `ssh myuser@ВАШ_IP` работает без ошибок |
-| Claude установлен | Команда `claude --version` показывает номер версии |
-| Claude авторизован | Команда `claude auth status` показывает `Logged in` |
-
----
-
-## Запуск бота
-
-**Вы установили Claude Code и авторизовались — отлично!**
-
-Теперь просто вставьте эту команду и следуйте подсказкам на экране:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/ВАШ_ЛОГИН/agent-second-brain/main/bootstrap.sh | bash
-```
-
-> **Замените `ВАШ_ЛОГИН`** на ваш логин GitHub!
-
-Скрипт сам:
-- Скачает ваш проект
-- Спросит у вас все токены (Telegram, Deepgram, Todoist)
-- Создаст файл с настройками
-- Настроит автозапуск
-- Запустит бота
-- Покажет статус
-
-**Если команда не сработала**, выполните вручную:
+## Installation
```bash
-cd ~
-git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git
-cd agent-second-brain
-bash setup.sh
+curl -fsSL https://raw.githubusercontent.com/smixs/agent-second-brain/main/install.sh | bash
```
----
+The script will install everything and prompt for your tokens.
-### Контрольная точка: Бот работает
+**Works on:** Mac, Windows (WSL)
-| Что проверить | Ожидаемый результат |
-|---------------|---------------------|
-| Бот отвечает на /start | В Telegram видны кнопки меню |
-| Голосовые распознаются | Бот отвечает текстом на голосовое сообщение |
-| Бот работает после перезагрузки | Перезагрузите сервер, бот снова отвечает |
+## Requirements
----
+| Service | Purpose | Cost |
+|---------|---------|------|
+| Claude Pro | AI processing | $20/month |
+| Telegram | Bot interface | Free |
+| Deepgram | Voice transcription | Free ($200 credit) |
+| Todoist | Task management | Free (optional) |
-# Часть 4: Использование
+## What You Need Before Installing
-### Кнопки бота
+1. **Claude Pro subscription** — [claude.ai/pricing](https://claude.ai/pricing)
+2. **Telegram Bot Token** — create via [@BotFather](https://t.me/BotFather)
+3. **Your Telegram ID** — get via [@userinfobot](https://t.me/userinfobot)
+4. **Deepgram API Key** — [console.deepgram.com](https://console.deepgram.com/)
+5. **Todoist API Token** (optional) — [Settings → Developer](https://todoist.com/app/settings/integrations/developer)
-```
-┌─────────────────────────────────────────┐
-│ [📊 Статус] [⚙️ Обработать] [📅 Неделя] │
-│ [✨ Запрос] [❓ Помощь] │
-└─────────────────────────────────────────┘
-```
-
-| Кнопка | Что делает |
-|--------|------------|
-| 📊 Статус | Показывает сколько записей сегодня |
-| ⚙️ Обработать | Запускает обработку всех записей |
-| 📅 Неделя | Показывает недельный дайджест |
-| ✨ Запрос | Можно попросить что-то сделать (самая крутая!) |
-| ❓ Помощь | Показывает справку |
-
----
-
-### Что можно отправлять
-
-**Голосовые** — основной способ:
-- «Надо написать Пете по проекту»
-- «Идея: сделать лендинг с калькулятором»
-
-**Текст** — ссылки, цитаты, быстрые мысли
-
-**Фото** — скриншоты, фото досок
-
-**Пересланные сообщения** — из других чатов
-
----
-
-### Кнопка «✨ Запрос»
-
-1. Нажмите **✨ Запрос**
-2. Бот спросит «Что сделать?»
-3. Отправьте голосовое или текст
-
-Примеры:
-- «покажи задачи на сегодня»
-- «перенеси просроченные на понедельник»
-- «создай задачу: позвонить в банк»
-
----
-
-# Часть 5: Синхронизация
-
-Ваши записи хранятся в папке `vault/`. Есть несколько способов их просматривать:
-
-### Способ 1: Obsidian (рекомендуем)
-
-**Что такое Obsidian:**
-Это бесплатное приложение для просмотра заметок с красивыми связями между ними. Вы сможете видеть все свои мысли, задачи и цели в удобном интерфейсе.
-
-<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.md](https://obsidian.md)
-2. Скачайте приложение для вашей системы и установите его
-3. Откройте Obsidian
-4. Нажмите **Open folder as vault**
-5. Найдите папку `agent-second-brain` (там, куда вы скачивали проект в Части 1)
-6. Внутри неё выберите папку `vault`
-7. Нажмите **Open**
-
-Теперь вы видите все свои заметки, цели и мысли в красивом интерфейсе.
-
-**На iPhone/iPad:**
-1. На компьютере переместите папку `vault` в iCloud Drive
-2. На iPhone скачайте Obsidian из App Store
-3. В приложении «Файлы» найдите папку `vault` в iCloud
-4. В Obsidian нажмите «Open folder as vault» → выберите эту папку
+## Running the Bot
-**На Android:**
-1. Установите [GitJournal](https://play.google.com/store/apps/details?id=io.gitjournal.gitjournal)
-2. Подключите ваш GitHub репозиторий
-3. Все заметки будут синхронизироваться автоматически
+After installation:
----
-
-### Способ 2: GitHub напрямую
-
-Все файлы хранятся в вашем репозитории на GitHub по адресу:
-```
-https://github.com/ВАШ_ЛОГИН/agent-second-brain
-```
-
-Вы можете:
-- Просматривать заметки прямо на сайте
-- Редактировать файлы через веб-интерфейс
-- Скачивать обновления командой `git pull`
-
----
-
-### Способ 3: Кнопка «✨ Запрос»
-
-Самый простой способ — спросить бота напрямую:
-- «Что я записал вчера?»
-- «Покажи мои цели на неделю»
-- «Какие задачи на сегодня?»
-- «Найди заметку про [тема]»
-
-Бот найдёт и покажет всё что нужно прямо в Telegram.
-
----
-
-# Помощь
-
-### Если что-то пошло не так
-
-Самый простой способ решить проблему — запустить программу `claude` прямо в чёрном окне сервера.
-
-1. Подключитесь к серверу (как в Части 3)
-2. Перейдите в папку проекта:
- ```bash
- cd ~/agent-second-brain
- ```
-3. Запустите Claude:
- ```bash
- claude
- ```
-4. Напишите ему:
- ```
- Я настраиваю бота, у меня возникла ошибка: [опишите что случилось]
- Что мне сделать?
- ```
-
-Claude прочитает файлы проекта и поможет решить проблему.
-
----
-
-### Частые проблемы
-
-**Бот не отвечает в Telegram:**
-Проверьте, работает ли он. Подключитесь к серверу и выполните:
```bash
-sudo systemctl status d-brain-bot
+cd ~/agent-second-brain && uv run python -m d_brain
```
-Должно показать `active (running)`.
-**Голосовые не распознаются:**
-Проверьте, правильно ли вы ввели ключ Deepgram при настройке.
+Or if you configured autostart, it runs automatically.
-**Claude не работает:**
-Проверьте авторизацию:
-```bash
-claude auth status
-```
-Если нужно авторизоваться заново:
-```bash
-claude auth login
-```
+## Features
----
+| Feature | Description |
+|---------|-------------|
+| Voice messages | Transcribed via Deepgram Nova-3 |
+| Text messages | Saved as-is |
+| Photos | Saved with captions |
+| Forwards | Saved with source attribution |
+| Processing | Classifies entries, creates tasks, saves thoughts |
+| Weekly digest | Analyzes your week, shows goal progress |
+| Custom requests | "Move overdue tasks", "Show today's tasks" |
-<details>
-<summary><strong>Технические детали (для продвинутых)</strong></summary>
+## Bot Commands
-### Полезные команды
+| Command | Action |
+|---------|--------|
+| `/start` | Start bot, show keyboard |
+| `/help` | Show help |
+| `/status` | How many entries today |
+| `/process` | Process entries (create tasks, save thoughts) |
+| `/weekly` | Generate weekly digest |
+| `/do [text]` | Execute custom request |
-```bash
-# Посмотреть логи бота
-sudo journalctl -u d-brain-bot -f
-
-# Перезапустить бота
-sudo systemctl restart d-brain-bot
-
-# Остановить бота
-sudo systemctl stop d-brain-bot
+## Vault Structure
-# Запустить бота
-sudo systemctl start d-brain-bot
```
-
-### MCP-серверы
-
-Эта система использует **MCP (Model Context Protocol)** — открытый стандарт от Anthropic для подключения AI к внешним сервисам.
-
-> **Рекомендуем:** Используйте [mcp-cli](docs/mcp-cli-setup.md) для стабильного подключения. Это обёртка с connection pooling и auto-retry — соединения не отваливаются.
-
-По умолчанию настроен 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, репозитории |
-
-Полный список: [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers)
-
-### Настройка systemd вручную
-
-Если автоматический скрипт не создал сервис:
-
-```bash
-sudo nano /etc/systemd/system/d-brain-bot.service
+vault/
+├── daily/ # Daily entries (YYYY-MM-DD.md)
+├── goals/ # Your goals (customize these!)
+├── thoughts/ # Processed thoughts
+│ ├── ideas/
+│ ├── projects/
+│ ├── learnings/
+│ └── reflections/
+├── summaries/ # Weekly digests
+└── attachments/ # Photos by date
```
-Вставьте (замените `myuser` на ваше имя пользователя):
-
-```ini
-[Unit]
-Description=d-brain Telegram Bot
-After=network.target
+## Advanced
-[Service]
-Type=simple
-User=myuser
-WorkingDirectory=/home/myuser/agent-second-brain
-ExecStart=/home/myuser/.local/bin/uv run python -m d_brain
-Restart=always
-RestartSec=10
+- [VPS Setup](docs/vps-setup.md) — Run 24/7 on a server
+- [MCP CLI Setup](docs/mcp-cli-setup.md) — Todoist integration details
-[Install]
-WantedBy=multi-user.target
-```
+## Troubleshooting
-Сохраните (`Ctrl+O`, Enter, `Ctrl+X`) и выполните:
+### Bot doesn't respond
```bash
-sudo systemctl daemon-reload
-sudo systemctl enable d-brain-bot
-sudo systemctl start d-brain-bot
-```
-
-</details>
+# Check if running
+ps aux | grep d_brain
----
-
-<details>
-<summary><strong>Инструкция для Claude Code (читает Claude, не вы)</strong></summary>
-
-### Команды с sudo
-
-Claude Code не может выполнять команды с `sudo` — они требуют ввода пароля.
-
-Когда нужно выполнить команду с sudo, попроси пользователя:
+# Check logs (if autostart configured)
+# Mac:
+tail -f ~/agent-second-brain/logs/bot.log
+# Linux/WSL:
+journalctl --user -u agent-second-brain -f
```
-Мне нужно выполнить команду с sudo, но я не могу ввести пароль.
-
-Пожалуйста, сделайте следующее:
-1. Откройте новую вкладку терминала (Ctrl+Shift+T или Cmd+T)
-2. Подключитесь к серверу:
- ssh ВАШ_ПОЛЬЗОВАТЕЛЬ@ВАШ_IP_АДРЕС
+### Voice not transcribing
-3. Выполните эту команду:
- sudo [КОМАНДА]
-
-4. Введите пароль когда попросят
-5. Вернитесь ко мне и скажите что готово
-```
-
-### Ручные шаги настройки
-
-**Проверка MCP Todoist:**
+Check your Deepgram key in `.env`:
```bash
-npx -y @doist/todoist-ai --help
+cat ~/agent-second-brain/.env | grep DEEPGRAM
```
-**Клонирование репозитория:**
-```bash
-cd ~
-mkdir -p projects
-cd projects
-git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git
-cd agent-second-brain
-uv sync
-```
+### Tasks not created
-**Создание .env:**
+Check your Todoist token:
```bash
-nano .env
+cat ~/agent-second-brain/.env | grep TODOIST
+mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}'
```
-Содержимое:
-```bash
-TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx
-DEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-TODOIST_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-VAULT_PATH=./vault
-ALLOWED_USER_IDS=[123456789]
-```
-
-> В `ALLOWED_USER_IDS` обязательно сохраняйте квадратные скобки!
-
-**Тестовый запуск:**
-```bash
-uv run python -m d_brain
-```
-
-**Настройка Git push:**
-```bash
-git config user.name "My Bot"
-git config user.email "[email protected]"
-```
-
-Создайте Personal Access Token на GitHub: Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token (scope: repo)
-
-```bash
-git remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/agent-second-brain.git
-```
-
-</details>
-
----
+## License
-*Версия 1.1.27*
+MIT
diff --git a/docs/vps-setup.md b/docs/vps-setup.md
new file mode 100644
index 0000000..bb1f4d9
--- /dev/null
+++ b/docs/vps-setup.md
@@ -0,0 +1,515 @@
+# VPS Setup Guide
+
+Run Agent Second Brain 24/7 on a virtual private server.
+
+## Requirements
+
+- VPS with Ubuntu 22.04+ (minimum 1GB RAM, recommended 2GB)
+- Root or sudo access
+- SSH client
+
+## Recommended VPS Providers
+
+| Provider | Price | Region |
+|----------|-------|--------|
+| Contabo | from $5/mo | Europe |
+| Hetzner | from $4/mo | Europe |
+| DigitalOcean | from $6/mo | Global |
+| Vultr | from $5/mo | Global |
+
+---
+
+## Step 1: Connect to Server
+
+After purchasing VPS, you'll get:
+- IP address (e.g., `162.55.123.45`)
+- Root password
+
+Connect via SSH:
+
+```bash
+```
+
+Enter password (characters won't display — that's normal).
+
+---
+
+## Step 2: Create User
+
+Never work as root. Create a regular user:
+
+```bash
+# Create user (replace "myuser" with your name)
+adduser myuser
+
+# Follow prompts:
+# - Enter password (twice)
+# - Other fields can be skipped (Enter)
+
+# Grant sudo rights
+usermod -aG sudo myuser
+
+# Switch to new user
+su - myuser
+```
+
+---
+
+## Step 3: Update System
+
+```bash
+sudo apt update && sudo apt upgrade -y
+```
+
+---
+
+## Step 4: Install Base Tools
+
+```bash
+# Git
+sudo apt install -y git
+
+# Curl and wget
+sudo apt install -y curl wget
+
+# Build tools
+sudo apt install -y build-essential
+
+# Verify
+git --version
+```
+
+---
+
+## Step 5: Install Python 3.12
+
+```bash
+sudo apt install -y software-properties-common
+sudo add-apt-repository -y ppa:deadsnakes/ppa
+sudo apt update
+sudo apt install -y python3.12 python3.12-venv python3.12-dev
+
+# Verify
+python3.12 --version
+```
+
+---
+
+## Step 6: Install uv
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+source ~/.bashrc
+
+# Verify
+uv --version
+```
+
+---
+
+## Step 7: Install Node.js
+
+Required for MCP servers (Todoist integration):
+
+```bash
+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+sudo apt install -y nodejs
+
+# Verify
+node --version
+npm --version
+```
+
+---
+
+## Step 8: Install Claude CLI
+
+```bash
+npm install -g @anthropic-ai/claude-code
+
+# Verify
+which claude
+claude --version
+
+# Authenticate
+claude auth login
+```
+
+After `claude auth login`:
+1. A URL appears
+2. Copy and open it in browser on your computer
+3. Log in to Anthropic account
+4. Authorize access
+5. Return to terminal — it will confirm
+
+---
+
+## Step 9: Clone Project
+
+```bash
+cd ~
+mkdir -p projects
+cd projects
+
+git clone https://github.com/smixs/agent-second-brain.git
+cd agent-second-brain
+
+ls -la
+```
+
+---
+
+## Step 10: Install Dependencies
+
+```bash
+uv sync
+
+# Verify
+uv run python -c "import aiogram; print('aiogram OK')"
+```
+
+---
+
+## Step 11: Get Tokens
+
+### Telegram Bot Token
+
+1. Open Telegram
+2. Find `@BotFather`
+3. Send `/newbot`
+4. Enter bot name and username
+5. Copy the token
+
+### Your Telegram User ID
+
+1. Find `@userinfobot` in Telegram
+2. Send any message
+3. Copy the ID number
+
+### Deepgram API Key
+
+1. Go to https://console.deepgram.com/
+2. Sign up (free $200 credit)
+3. Settings → API Keys
+4. Create key and copy
+
+### Todoist API Token (optional)
+
+1. Go to https://todoist.com/
+2. Settings → Integrations → Developer
+3. Copy API token
+
+---
+
+## Step 12: Configure Environment
+
+```bash
+nano ~/projects/agent-second-brain/.env
+```
+
+Paste (replace with your values):
+
+```bash
+TELEGRAM_BOT_TOKEN=7123456789:AAHdN8J2K4m5N6o7P8q9R0s1T2u3V4w5X6y
+DEEPGRAM_API_KEY=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0
+TODOIST_API_KEY=
+VAULT_PATH=./vault
+ALLOWED_USER_IDS=[123456789]
+```
+
+Save: `Ctrl+O`, `Enter`, `Ctrl+X`
+
+---
+
+## Step 13: Clean Vault Examples
+
+```bash
+cd ~/projects/agent-second-brain
+
+rm -rf vault/daily/*
+rm -rf vault/thoughts/ideas/*
+rm -rf vault/thoughts/projects/*
+rm -rf vault/thoughts/learnings/*
+rm -rf vault/thoughts/reflections/*
+rm -rf vault/summaries/*
+rm -rf vault/attachments/*
+```
+
+---
+
+## Step 14: Customize Goals
+
+Edit goals to match yours:
+
+```bash
+nano vault/goals/0-vision-3y.md # 3-year vision
+nano vault/goals/1-yearly-2026.md # Yearly goals
+nano vault/goals/2-monthly.md # Monthly priorities
+nano vault/goals/3-weekly.md # Weekly focus
+```
+
+---
+
+## Step 15: Test Run
+
+```bash
+cd ~/projects/agent-second-brain
+uv run python -m d_brain
+```
+
+Should show:
+```
+INFO:aiogram.dispatcher:Start polling
+INFO:aiogram.dispatcher:Run polling for bot @your_bot_name
+```
+
+Test in Telegram:
+- Find your bot
+- Send `/start`
+- Send a voice message
+
+Stop with `Ctrl+C`.
+
+---
+
+## Step 16: Setup Autostart (systemd)
+
+### Bot Service
+
+```bash
+sudo nano /etc/systemd/system/d-brain-bot.service
+```
+
+Paste (replace `myuser`):
+
+```ini
+[Unit]
+Description=d-brain Telegram Bot
+After=network.target
+
+[Service]
+Type=simple
+User=myuser
+WorkingDirectory=/home/myuser/projects/agent-second-brain
+ExecStart=/home/myuser/.local/bin/uv run python -m d_brain
+Restart=always
+RestartSec=10
+Environment=PYTHONUNBUFFERED=1
+
+[Install]
+WantedBy=multi-user.target
+```
+
+Enable and start:
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl start d-brain-bot
+sudo systemctl enable d-brain-bot
+
+# Check status
+sudo systemctl status d-brain-bot
+```
+
+---
+
+## Step 17: Daily Processing Timer (optional)
+
+Automatically process entries at 21:00 daily.
+
+### Edit process script
+
+```bash
+nano ~/projects/agent-second-brain/scripts/process.sh
+```
+
+Update paths at the top:
+```bash
+export HOME="/home/myuser"
+PROJECT_DIR="/home/myuser/projects/agent-second-brain"
+```
+
+Make executable:
+```bash
+chmod +x ~/projects/agent-second-brain/scripts/process.sh
+```
+
+### Create timer
+
+```bash
+sudo nano /etc/systemd/system/d-brain-process.timer
+```
+
+```ini
+[Unit]
+Description=Run d-brain processing daily at 21:00
+
+[Timer]
+OnCalendar=*-*-* 21:00:00
+Persistent=true
+
+[Install]
+WantedBy=timers.target
+```
+
+### Create service
+
+```bash
+sudo nano /etc/systemd/system/d-brain-process.service
+```
+
+```ini
+[Unit]
+Description=d-brain Daily Processing
+
+[Service]
+Type=oneshot
+User=myuser
+WorkingDirectory=/home/myuser/projects/agent-second-brain
+ExecStart=/home/myuser/projects/agent-second-brain/scripts/process.sh
+Environment=PYTHONUNBUFFERED=1
+```
+
+### Enable
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl enable d-brain-process.timer
+sudo systemctl start d-brain-process.timer
+
+# Check timer
+sudo systemctl list-timers | grep d-brain
+```
+
+---
+
+## Step 18: Git Configuration
+
+```bash
+cd ~/projects/agent-second-brain
+
+git config user.email "[email protected]"
+git config user.name "Your Name"
+```
+
+### Create your own repository
+
+1. GitHub → "+" → "New repository"
+2. Name: `my-second-brain`
+3. Leave empty (no README)
+4. Create
+
+### Change remote
+
+```bash
+git remote set-url origin https://github.com/YOUR_USERNAME/my-second-brain.git
+git remote -v
+git push -u origin main
+```
+
+If prompted for password, use Personal Access Token:
+- GitHub → Settings → Developer settings → Personal access tokens
+
+---
+
+## Useful Commands
+
+```bash
+# Bot status
+sudo systemctl status d-brain-bot
+
+# Restart bot
+sudo systemctl restart d-brain-bot
+
+# Stop bot
+sudo systemctl stop d-brain-bot
+
+# Real-time logs
+sudo journalctl -u d-brain-bot -f
+
+# Last 100 log lines
+sudo journalctl -u d-brain-bot -n 100
+
+# All d-brain services
+sudo systemctl status 'd-brain-*'
+
+# List timers
+sudo systemctl list-timers
+
+# Manual processing
+cd ~/projects/agent-second-brain
+./scripts/process.sh
+
+# Update code
+cd ~/projects/agent-second-brain
+git pull
+uv sync
+sudo systemctl restart d-brain-bot
+```
+
+---
+
+## Troubleshooting
+
+### Bot doesn't respond
+
+```bash
+sudo systemctl status d-brain-bot
+sudo journalctl -u d-brain-bot -n 100
+cat ~/projects/agent-second-brain/.env | grep TELEGRAM_BOT_TOKEN
+sudo systemctl restart d-brain-bot
+```
+
+### Voice not transcribing
+
+```bash
+cat ~/projects/agent-second-brain/.env | grep DEEPGRAM
+sudo journalctl -u d-brain-bot | grep -i error
+```
+
+### Processing errors
+
+```bash
+claude --version
+claude auth status
+claude auth login # if needed
+```
+
+### Todoist not working
+
+```bash
+cat ~/projects/agent-second-brain/.env | grep TODOIST
+mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}'
+```
+
+### Permission errors
+
+```bash
+sudo chown -R myuser:myuser ~/projects/agent-second-brain
+chmod -R 755 ~/projects/agent-second-brain
+```
+
+### Git push fails
+
+```bash
+git remote -v
+git status
+git config --global credential.helper store
+git push
+```
+
+---
+
+## Sync with Local Computer
+
+See main [README](../README.md) for Obsidian sync options.
+
+---
+
+## Security Tips
+
+- Use SSH keys instead of passwords
+- Keep system updated: `sudo apt update && sudo apt upgrade`
+- `.env` is in `.gitignore` — never commit tokens
+- Consider setting up firewall: `sudo ufw enable`
diff --git a/install.sh b/install.sh
new file mode 100755
index 0000000..751c10c
--- /dev/null
+++ b/install.sh
@@ -0,0 +1,525 @@
+#!/bin/bash
+# Agent Second Brain — One-command installer
+# Works on Mac and Windows WSL
+# https://github.com/smixs/agent-second-brain
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Config
+REPO_URL="https://github.com/smixs/agent-second-brain.git"
+INSTALL_DIR="$HOME/agent-second-brain"
+
+#######################################
+# Print colored message
+#######################################
+info() { echo -e "${BLUE}ℹ${NC} $1"; }
+success() { echo -e "${GREEN}✓${NC} $1"; }
+warn() { echo -e "${YELLOW}⚠${NC} $1"; }
+error() { echo -e "${RED}✗${NC} $1"; exit 1; }
+
+#######################################
+# Detect OS
+#######################################
+detect_os() {
+ if [[ "$OSTYPE" == "darwin"* ]]; then
+ OS="mac"
+ info "Detected: macOS"
+ elif grep -q Microsoft /proc/version 2>/dev/null; then
+ OS="wsl"
+ info "Detected: Windows WSL"
+ elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+ OS="linux"
+ info "Detected: Linux"
+ else
+ error "Unsupported OS. This script works on Mac and Windows WSL only."
+ fi
+}
+
+#######################################
+# Check if command exists
+#######################################
+has_command() {
+ command -v "$1" &> /dev/null
+}
+
+#######################################
+# Install Homebrew (Mac only)
+#######################################
+install_homebrew() {
+ if [[ "$OS" != "mac" ]]; then return; fi
+
+ if has_command brew; then
+ success "Homebrew already installed"
+ else
+ info "Installing Homebrew..."
+ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+
+ # Add to PATH for current session
+ if [[ -f /opt/homebrew/bin/brew ]]; then
+ eval "$(/opt/homebrew/bin/brew shellenv)"
+ elif [[ -f /usr/local/bin/brew ]]; then
+ eval "$(/usr/local/bin/brew shellenv)"
+ fi
+
+ success "Homebrew installed"
+ fi
+}
+
+#######################################
+# Install dependencies
+#######################################
+install_dependencies() {
+ info "Installing dependencies..."
+
+ if [[ "$OS" == "mac" ]]; then
+ # Node.js
+ if ! has_command node; then
+ info "Installing Node.js..."
+ brew install node
+ fi
+ success "Node.js $(node --version)"
+
+ # Python 3.12
+ if ! has_command python3.12; then
+ info "Installing Python 3.12..."
+ brew install [email protected]
+ fi
+ success "Python $(python3.12 --version)"
+
+ # Git
+ if ! has_command git; then
+ info "Installing Git..."
+ brew install git
+ fi
+ success "Git $(git --version | head -1)"
+
+ elif [[ "$OS" == "wsl" ]] || [[ "$OS" == "linux" ]]; then
+ info "Updating apt packages..."
+ sudo apt update && sudo apt upgrade -y
+
+ # Node.js 20
+ if ! has_command node; then
+ info "Installing Node.js..."
+ curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+ sudo apt install -y nodejs
+ fi
+ success "Node.js $(node --version)"
+
+ # Python 3.12
+ if ! has_command python3.12; then
+ info "Installing Python 3.12..."
+ sudo apt install -y software-properties-common
+ sudo add-apt-repository -y ppa:deadsnakes/ppa
+ sudo apt update
+ sudo apt install -y python3.12 python3.12-venv python3.12-dev
+ fi
+ success "Python $(python3.12 --version)"
+
+ # Git
+ if ! has_command git; then
+ info "Installing Git..."
+ sudo apt install -y git curl wget
+ fi
+ success "Git $(git --version | head -1)"
+ fi
+}
+
+#######################################
+# Install uv (Python package manager)
+#######################################
+install_uv() {
+ if has_command uv; then
+ success "uv already installed: $(uv --version)"
+ else
+ info "Installing uv..."
+ curl -LsSf https://astral.sh/uv/install.sh | sh
+
+ # Add to PATH for current session
+ export PATH="$HOME/.local/bin:$PATH"
+
+ success "uv installed: $(uv --version)"
+ fi
+}
+
+#######################################
+# Install Claude Code CLI
+#######################################
+install_claude() {
+ if has_command claude; then
+ success "Claude Code already installed: $(claude --version)"
+ else
+ info "Installing Claude Code CLI..."
+ npm install -g @anthropic-ai/claude-code
+ success "Claude Code installed"
+ fi
+}
+
+#######################################
+# Clone repository
+#######################################
+clone_repo() {
+ if [[ -d "$INSTALL_DIR" ]]; then
+ warn "Directory $INSTALL_DIR already exists"
+ read -p "Overwrite? (y/n): " -n 1 -r
+ echo
+ if [[ $REPLY =~ ^[Yy]$ ]]; then
+ rm -rf "$INSTALL_DIR"
+ else
+ error "Installation cancelled"
+ fi
+ fi
+
+ info "Cloning repository..."
+ git clone "$REPO_URL" "$INSTALL_DIR"
+ success "Repository cloned to $INSTALL_DIR"
+}
+
+#######################################
+# Prompt for token
+#######################################
+prompt_token() {
+ local name="$1"
+ local desc="$2"
+ local url="$3"
+ local var_name="$4"
+ local optional="${5:-false}"
+
+ echo
+ echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+ echo -e "${YELLOW}$name${NC}"
+ echo "$desc"
+ echo -e "Get it here: ${GREEN}$url${NC}"
+ echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+
+ if [[ "$optional" == "true" ]]; then
+ read -p "Enter token (or press Enter to skip): " token
+ else
+ while true; do
+ read -p "Enter token: " token
+ if [[ -n "$token" ]]; then
+ break
+ fi
+ warn "This token is required"
+ done
+ fi
+
+ eval "$var_name=\"$token\""
+}
+
+#######################################
+# Collect tokens interactively
+#######################################
+collect_tokens() {
+ echo
+ echo -e "${GREEN}╔════════════════════════════════════════════════╗${NC}"
+ echo -e "${GREEN}║ TOKEN CONFIGURATION ║${NC}"
+ echo -e "${GREEN}╚════════════════════════════════════════════════╝${NC}"
+ echo
+ echo "You'll need to provide 4 tokens. Instructions for each below."
+
+ # Telegram Bot Token
+ prompt_token \
+ "1/4: Telegram Bot Token" \
+ "Create a bot via @BotFather in Telegram:
+1. Open Telegram and search for @BotFather
+2. Send /newbot
+3. Follow instructions to create your bot
+4. Copy the token (looks like: 7123456789:AAHd...)" \
+ "https://t.me/BotFather" \
+ "TELEGRAM_BOT_TOKEN"
+
+ # Telegram User ID
+ prompt_token \
+ "2/4: Your Telegram User ID" \
+ "Get your ID via @userinfobot:
+1. Search for @userinfobot in Telegram
+2. Send any message
+3. Copy your ID (just the number)" \
+ "https://t.me/userinfobot" \
+ "TELEGRAM_USER_ID"
+
+ # Deepgram API Key
+ prompt_token \
+ "3/4: Deepgram API Key" \
+ "For voice transcription (free \$200 credit):
+1. Sign up at console.deepgram.com
+2. Go to Settings → API Keys
+3. Create new key and copy it" \
+ "https://console.deepgram.com/" \
+ "DEEPGRAM_API_KEY"
+
+ # Todoist API Token (optional)
+ prompt_token \
+ "4/4: Todoist API Token (optional)" \
+ "For task management:
+1. Log in to todoist.com
+2. Settings → Integrations → Developer
+3. Copy the API token" \
+ "https://todoist.com/app/settings/integrations/developer" \
+ "TODOIST_API_KEY" \
+ "true"
+}
+
+#######################################
+# Create .env file
+#######################################
+create_env() {
+ info "Creating .env file..."
+
+ cat > "$INSTALL_DIR/.env" << EOF
+# Telegram Bot Token (from @BotFather)
+TELEGRAM_BOT_TOKEN=$TELEGRAM_BOT_TOKEN
+
+# Deepgram API Key (from console.deepgram.com)
+DEEPGRAM_API_KEY=$DEEPGRAM_API_KEY
+
+# Todoist API Token (optional)
+TODOIST_API_KEY=$TODOIST_API_KEY
+
+# Path to vault (don't change)
+VAULT_PATH=./vault
+
+# Your Telegram ID (bot responds only to you)
+ALLOWED_USER_IDS=[$TELEGRAM_USER_ID]
+EOF
+
+ success ".env file created"
+}
+
+#######################################
+# Install Python dependencies
+#######################################
+install_python_deps() {
+ info "Installing Python dependencies..."
+ cd "$INSTALL_DIR"
+ uv sync
+ success "Python dependencies installed"
+}
+
+#######################################
+# Install mcp-cli
+#######################################
+install_mcp_cli() {
+ if has_command mcp-cli; then
+ success "mcp-cli already installed"
+ else
+ info "Installing mcp-cli..."
+ curl -fsSL https://raw.githubusercontent.com/philschmid/mcp-cli/main/install.sh | bash
+ export PATH="$HOME/.local/bin:$PATH"
+ success "mcp-cli installed"
+ fi
+
+ # Configure mcp-cli for Todoist if token provided
+ if [[ -n "$TODOIST_API_KEY" ]]; then
+ info "Configuring mcp-cli for Todoist..."
+ mkdir -p ~/.config/mcp
+ cat > ~/.config/mcp/mcp_servers.json << EOF
+{
+ "mcpServers": {
+ "todoist": {
+ "command": "npx",
+ "args": ["-y", "@doist/todoist-ai"],
+ "env": {
+ "TODOIST_API_KEY": "$TODOIST_API_KEY"
+ }
+ }
+ }
+}
+EOF
+ success "mcp-cli configured"
+ fi
+}
+
+#######################################
+# Authenticate Claude
+#######################################
+auth_claude() {
+ echo
+ echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+ echo -e "${YELLOW}Claude Authentication${NC}"
+ echo "You need Claude Pro subscription (\$20/month) for this to work."
+ echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+ echo
+
+ if claude auth status &>/dev/null; then
+ success "Claude already authenticated"
+ else
+ info "Starting Claude authentication..."
+ echo "A browser window will open. Log in with your Anthropic account."
+ echo
+ claude auth login
+ success "Claude authenticated"
+ fi
+}
+
+#######################################
+# Setup autostart (optional)
+#######################################
+setup_autostart() {
+ echo
+ read -p "Configure autostart (bot runs when computer starts)? (y/n): " -n 1 -r
+ echo
+
+ if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+ info "Skipping autostart configuration"
+ return
+ fi
+
+ if [[ "$OS" == "mac" ]]; then
+ setup_launchd
+ else
+ setup_systemd
+ fi
+}
+
+#######################################
+# Setup launchd (Mac)
+#######################################
+setup_launchd() {
+ info "Configuring launchd..."
+
+ mkdir -p ~/Library/LaunchAgents
+
+ cat > ~/Library/LaunchAgents/com.agent-second-brain.plist << EOF
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+ <key>Label</key>
+ <string>com.agent-second-brain</string>
+ <key>ProgramArguments</key>
+ <array>
+ <string>$HOME/.local/bin/uv</string>
+ <string>run</string>
+ <string>python</string>
+ <string>-m</string>
+ <string>d_brain</string>
+ </array>
+ <key>WorkingDirectory</key>
+ <string>$INSTALL_DIR</string>
+ <key>RunAtLoad</key>
+ <true/>
+ <key>KeepAlive</key>
+ <true/>
+ <key>StandardOutPath</key>
+ <string>$INSTALL_DIR/logs/bot.log</string>
+ <key>StandardErrorPath</key>
+ <string>$INSTALL_DIR/logs/bot-error.log</string>
+</dict>
+</plist>
+EOF
+
+ mkdir -p "$INSTALL_DIR/logs"
+ launchctl load ~/Library/LaunchAgents/com.agent-second-brain.plist
+
+ success "Autostart configured (launchd)"
+ info "Bot will start automatically on login"
+}
+
+#######################################
+# Setup systemd (Linux/WSL)
+#######################################
+setup_systemd() {
+ info "Configuring systemd..."
+
+ mkdir -p ~/.config/systemd/user
+
+ cat > ~/.config/systemd/user/agent-second-brain.service << EOF
+[Unit]
+Description=Agent Second Brain Telegram Bot
+After=network.target
+
+[Service]
+Type=simple
+WorkingDirectory=$INSTALL_DIR
+ExecStart=$HOME/.local/bin/uv run python -m d_brain
+Restart=always
+RestartSec=10
+Environment=PYTHONUNBUFFERED=1
+
+[Install]
+WantedBy=default.target
+EOF
+
+ systemctl --user daemon-reload
+ systemctl --user enable agent-second-brain
+ systemctl --user start agent-second-brain
+
+ success "Autostart configured (systemd)"
+ info "Bot is running now and will start on boot"
+}
+
+#######################################
+# Start bot manually
+#######################################
+start_bot() {
+ echo
+ echo -e "${GREEN}╔════════════════════════════════════════════════╗${NC}"
+ echo -e "${GREEN}║ INSTALLATION COMPLETE! ║${NC}"
+ echo -e "${GREEN}╚════════════════════════════════════════════════╝${NC}"
+ echo
+
+ if [[ "$OS" == "mac" ]] && [[ -f ~/Library/LaunchAgents/com.agent-second-brain.plist ]]; then
+ echo "Bot is running in background."
+ echo
+ echo "Commands:"
+ echo " Stop: launchctl unload ~/Library/LaunchAgents/com.agent-second-brain.plist"
+ echo " Start: launchctl load ~/Library/LaunchAgents/com.agent-second-brain.plist"
+ echo " Logs: tail -f $INSTALL_DIR/logs/bot.log"
+ elif systemctl --user is-active --quiet agent-second-brain 2>/dev/null; then
+ echo "Bot is running in background."
+ echo
+ echo "Commands:"
+ echo " Stop: systemctl --user stop agent-second-brain"
+ echo " Start: systemctl --user start agent-second-brain"
+ echo " Logs: journalctl --user -u agent-second-brain -f"
+ else
+ echo "To start the bot manually:"
+ echo
+ echo -e " ${GREEN}cd $INSTALL_DIR && uv run python -m d_brain${NC}"
+ echo
+ read -p "Start bot now? (y/n): " -n 1 -r
+ echo
+ if [[ $REPLY =~ ^[Yy]$ ]]; then
+ cd "$INSTALL_DIR"
+ info "Starting bot... (Ctrl+C to stop)"
+ uv run python -m d_brain
+ fi
+ fi
+}
+
+#######################################
+# Main
+#######################################
+main() {
+ echo
+ echo -e "${GREEN}╔════════════════════════════════════════════════╗${NC}"
+ echo -e "${GREEN}║ AGENT SECOND BRAIN INSTALLER ║${NC}"
+ echo -e "${GREEN}║ ║${NC}"
+ echo -e "${GREEN}║ Voice-first AI assistant with memory ║${NC}"
+ echo -e "${GREEN}╚════════════════════════════════════════════════╝${NC}"
+ echo
+
+ detect_os
+ install_homebrew
+ install_dependencies
+ install_uv
+ install_claude
+ clone_repo
+ collect_tokens
+ create_env
+ install_python_deps
+ install_mcp_cli
+ auth_claude
+ setup_autostart
+ start_bot
+}
+
+main "$@"