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.
Python ai-agentsai-automationclaudeclaude-codeebbinghausknowledge-graphllmmemory-systemobsidianpersonal-assistantpkmproductivitypythonsecond-braintelegram-botvoice-assistant
chore: v3.0.0 metadata + README sweep for removed integrations
smixs5a45ce0a32bd
diff --git a/README.md b/README.mdindex 059130d..ef23f3e 100644--- a/README.md+++ b/README.md@@ -30,7 +30,6 @@ The agent handles everything else:- **Transcribes** your voice notes (Deepgram, takes seconds)- **Classifies** each entry - task, idea, client note, goal update, random thought-- **Creates tasks** in Todoist with the right priority and due date- **Saves everything** to an Obsidian vault with proper links and tags- **Sends you a daily report** at 9pm - what happened, what got done, what's still hanging- **Remembers what matters, forgets what doesn't** - memory fades over time like a real brain@@ -45,15 +44,15 @@ This isn't a button-pressing bot. You have a conversation.>> **Bot:** *finds and shows relevant entries*>-> **You:** turn the second idea into a task for Monday+> **You:** turn the second idea into a project note with next steps>-> **Bot:** *creates the task in Todoist*+> **Bot:** *creates the note, links it to related entries*>-> **You:** actually make it high priority and add a subtask for the presentation+> **You:** actually add a step for the presentation>-> **Bot:** *updates the task*+> **Bot:** *updates the note*-It has access to your entire vault, all your goals, and your Todoist. Ask it anything about your own notes, and it'll find the answer.+It has access to your entire vault and all your goals. Ask it anything about your own notes, and it'll find the answer.## Memory that works like memory@@ -91,25 +90,25 @@ You don't run maintenance. The agent does.| You send | Agent does ||----------|-----------|-| Voice note about a client call | Transcribes, creates CRM card, adds follow-up task |+| Voice note about a client call | Transcribes, creates CRM card with a follow-up || Quick text: "idea for the Q2 campaign" | Saves to ideas folder, links to related notes || Forwarded article from a chat | Saves with source, extracts key points || Photo of a whiteboard | Saves with AI-generated description || "Process" button | Runs the full pipeline right now |-| "What are my priorities this week?" | Reads your goals and Todoist, gives you a straight answer |+| "What are my priorities this week?" | Reads your goals, gives you a straight answer |## How it works (for the curious)The daily processing runs in three phases:1. **Capture** - reads today's entries, classifies each one (task? idea? CRM update? goal progress?)-2. **Execute** - creates Todoist tasks, writes vault files, updates cards+2. **Execute** - writes vault files, updates cards3. **Reflect** - generates a summary report, updates long-term memory, sends it to TelegramEach phase produces a clean JSON that the next phase picks up. If something breaks, you can see exactly where and why.```-Telegram → Deepgram → Claude Code → Todoist + Obsidian vault → Telegram report+Telegram → Deepgram → Claude Code → Obsidian vault → Telegram report```**Always-on, on your subscription.** The bot doesn't spawn a fresh `claude` for every message. It keeps one long-lived *interactive* Claude Code session alive in a tmux pane and types your prompts into it. That keeps it on your Claude subscription (interactive usage) instead of per-request API billing. A watchdog and a daily self-check keep that session healthy around the clock and restart it automatically if it ever wedges — so the bot just stays up.@@ -121,12 +120,11 @@ Telegram → Deepgram → Claude Code → Todoist + Obsidian vault → Telegram| Claude Pro | $20/mo || VPS (any cheap one works) | ~$5/mo || Deepgram | Free tier ($200 credit) |-| Todoist | Free plan works || **Total** | **~$25/mo** |$25/month for a personal assistant that organizes your life, never sleeps, and gets better the more you use it.-> **Why this matters (June 2026).** From June 15, 2026 Anthropic moves `claude -p` / headless runs onto a separate paid Agent SDK credit, billed per request. Agent Second Brain **v3.1** sidesteps that completely: it drives a persistent *interactive* session, which stays on your flat Pro/Max subscription. No per-request billing, no surprise invoice — the price above stays the price. (If you ever do want the API path, an opt-in `DBRAIN_MODE=router` escape hatch is built in.)+> **Why this matters (June 2026).** From June 15, 2026 Anthropic moves `claude -p` / headless runs onto a separate paid Agent SDK credit, billed per request. Agent Second Brain **v3.0** sidesteps that completely: it drives a persistent *interactive* session, which stays on your flat Pro/Max subscription. No per-request billing, no surprise invoice — the price above stays the price.## Quick start@@ -149,14 +147,13 @@ Open these files and replace the placeholders:- `vault/.claude/skills/dbrain-processor/references/about.md` - tell the agent about yourself- `vault/.claude/skills/dbrain-processor/references/classification.md` - how you want entries sorted-### 4. Get four API keys+### 4. Get three API keys| What | Where | Time ||------|-------|------|| Telegram Bot Token | [@BotFather](https://t.me/BotFather) | 2 min || Your Telegram ID | [@userinfobot](https://t.me/userinfobot) | 30 sec || Deepgram API Key | [console.deepgram.com](https://console.deepgram.com/) | 3 min |-| Todoist API Token | Todoist → Settings → Integrations → Developer | 1 min |### 5. Deploy@@ -200,15 +197,14 @@ vault/## Skills-The agent has five built-in skills:+The agent has four built-in skills:| Skill | What it does ||-------|-------------|-| **dbrain-processor** | Classifies entries, creates tasks, saves notes |+| **dbrain-processor** | Classifies entries, saves notes || **agent-memory** | Ebbinghaus decay engine - remembers, forgets, recalls || **vault-health** | Scores vault health, fixes links, generates MOCs || **graph-builder** | Maps relationships between notes, finds clusters |-| **todoist-ai** | Manages tasks, projects, priorities |Want just the memory engine? See [agent-memory-skill](https://github.com/smixs/agent-memory-skill) - works standalone, no dependencies.@@ -218,7 +214,6 @@ Want just the memory engine? See [agent-memory-skill](https://github.com/smixs/a|------|-----------------|| `.env` | API tokens (copy from `.env.example`) || `.memory-config.json` | How fast memories decay, tier boundaries |-| `mcp-config.json` | External tool connections || `vault/.claude/CLAUDE.md` | Agent personality and rules |All secrets stay in `.env`, which is gitignored. Don't commit tokens.diff --git a/README.ru.md b/README.ru.mdindex 4c8352b..1438190 100644--- a/README.ru.md+++ b/README.ru.md@@ -30,7 +30,6 @@- **Расшифровывает** голосовые (Deepgram, пара секунд)- **Классифицирует** каждую запись - задача, идея, заметка о клиенте, прогресс по цели, случайная мысль-- **Создаёт задачи** в Todoist с нужным приоритетом и датой- **Сохраняет всё** в Obsidian-хранилище с правильными ссылками и тегами- **Присылает дневной отчёт** в 21:00 - что произошло, что сделано, что висит- **Помнит важное, забывает ненужное** - память угасает со временем, как у живого человека@@ -45,15 +44,15 @@>> **Бот:** *находит и показывает записи*>-> **Ты:** вторую идею превращай в задачу на понедельник+> **Ты:** вторую идею оформи как заметку-проект с следующими шагами>-> **Бот:** *создаёт задачу в Todoist*+> **Бот:** *создаёт заметку и связывает её с похожими записями*>-> **Ты:** сделай высокий приоритет и добавь подзадачу на презентацию+> **Ты:** добавь шаг про презентацию>-> **Бот:** *обновляет задачу*+> **Бот:** *обновляет заметку*-У агента доступ ко всему хранилищу, всем целям и Todoist. Спроси что угодно про свои записи - найдёт.+У агента доступ ко всему хранилищу и всем целям. Спроси что угодно про свои записи - найдёт.## Память, которая работает как память@@ -91,25 +90,25 @@ Agent Second Brain использует кривую забывания Эбби| Ты отправляешь | Агент делает ||----------------|-------------|-| Голосовое о звонке с клиентом | Расшифровывает, создаёт CRM-карточку, добавляет follow-up задачу |+| Голосовое о звонке с клиентом | Расшифровывает, создаёт CRM-карточку с follow-up || Текст: «идея для Q2 кампании» | Сохраняет в папку идей, связывает с похожими заметками || Пересланная статья из чата | Сохраняет с источником, вытаскивает ключевые мысли || Фото доски | Сохраняет с AI-описанием || Кнопка «Process» | Запускает полный цикл обработки прямо сейчас |-| «Какие приоритеты на эту неделю?» | Читает цели и Todoist, даёт прямой ответ |+| «Какие приоритеты на эту неделю?» | Читает цели, даёт прямой ответ |## Как это работает (для любопытных)Ежедневная обработка идёт в три фазы:1. **Захват** - читает записи за день, классифицирует каждую (задача? идея? обновление CRM? прогресс по цели?)-2. **Исполнение** - создаёт задачи в Todoist, пишет файлы в хранилище, обновляет карточки+2. **Исполнение** - пишет файлы в хранилище, обновляет карточки3. **Рефлексия** - генерирует сводный отчёт, обновляет долговременную память, отправляет в TelegramКаждая фаза создаёт чистый JSON, который подхватывает следующая. Если что-то ломается - видно где именно и почему.```-Telegram → Deepgram → Claude Code → Todoist + Obsidian → Telegram отчёт+Telegram → Deepgram → Claude Code → Obsidian → Telegram отчёт```**Всегда на связи, на твоей подписке.** Бот не запускает новый `claude` на каждое сообщение. Он держит одну живую *интерактивную* сессию Claude Code в tmux-панели и «печатает» в неё твои промпты. Это оставляет его на твоей подписке Claude (интерактивное использование), а не на поштучной оплате API. Watchdog и ежедневная самодиагностика следят за здоровьем сессии круглосуточно и автоматически перезапускают её, если она зависнет - бот просто остаётся живым.@@ -121,12 +120,11 @@ Telegram → Deepgram → Claude Code → Todoist + Obsidian → Telegram отч| Claude Pro | $20/мес || VPS (любой дешёвый) | ~$5/мес || Deepgram | Бесплатно ($200 кредит) |-| Todoist | Бесплатный план работает || **Итого** | **~$25/мес** |$25 в месяц за личного ассистента, который организует твою жизнь, никогда не спит и становится лучше с каждым днём использования.-> **Почему это важно (июнь 2026).** С 15 июня 2026 Anthropic переводит `claude -p` / headless-запуски на отдельный платный кредит Agent SDK с поштучной оплатой. Agent Second Brain **v3.1** обходит это полностью: он гоняет постоянную *интерактивную* сессию, которая остаётся на твоей фиксированной подписке Pro/Max. Никакой поштучной оплаты и неожиданных счетов - цена выше остаётся ценой. (Если всё же захочешь API-путь - встроен опциональный escape-hatch `DBRAIN_MODE=router`.)+> **Почему это важно (июнь 2026).** С 15 июня 2026 Anthropic переводит `claude -p` / headless-запуски на отдельный платный кредит Agent SDK с поштучной оплатой. Agent Second Brain **v3.0** обходит это полностью: он гоняет постоянную *интерактивную* сессию, которая остаётся на твоей фиксированной подписке Pro/Max. Никакой поштучной оплаты и неожиданных счетов - цена выше остаётся ценой.## Быстрый старт@@ -149,14 +147,13 @@ cd agent-second-brain- `vault/.claude/skills/dbrain-processor/references/about.md` - расскажи агенту о себе- `vault/.claude/skills/dbrain-processor/references/classification.md` - как сортировать записи-### 4. Получи четыре API-ключа+### 4. Получи три API-ключа| Что | Где взять | Время ||-----|----------|-------|| Telegram Bot Token | [@BotFather](https://t.me/BotFather) | 2 мин || Твой Telegram ID | [@userinfobot](https://t.me/userinfobot) | 30 сек || Deepgram API Key | [console.deepgram.com](https://console.deepgram.com/) | 3 мин |-| Todoist API Token | Todoist → Settings → Integrations → Developer | 1 мин |### 5. Разверни@@ -206,7 +203,6 @@ vault/| **agent-memory** | Движок памяти Эббингауза - помнит, забывает, вспоминает || **vault-health** | Оценка здоровья, починка ссылок, генерация MOC || **graph-builder** | Карта связей между заметками, поиск кластеров |-| **todoist-ai** | Управление задачами, проектами, приоритетами |Нужен только движок памяти? Смотри [agent-memory-skill](https://github.com/smixs/agent-memory-skill) - работает отдельно, без зависимостей.diff --git a/docs/mcp-cli-setup.md b/docs/mcp-cli-setup.mddeleted file mode 100644index c91adae..0000000--- a/docs/mcp-cli-setup.md+++ /dev/null@@ -1,194 +0,0 @@-# MCP через mcp-cli--Стабильное подключение к MCP серверам через mcp-cli вместо прямого протокола.--## Зачем это нужно--MCP протокол напрямую иногда отваливается. mcp-cli решает эту проблему:--- **Connection pooling** - daemon держит соединения-- **Auto-retry** - автоматические повторы при сетевых ошибках-- **Стабильность** - работа через bash надёжнее чем MCP протокол напрямую--## Как это работает--```-До:-Claude → MCP Protocol → Todoist MCP Server → Todoist API- (отваливается)--После:-Claude → Bash → mcp-cli → Todoist MCP Server → Todoist API- (daemon, retry, pooling)-```-------## Установка--### 1. Установите mcp-cli--```bash-curl -fsSL https://raw.githubusercontent.com/philschmid/mcp-cli/main/install.sh | bash-```--Проверка:-```bash-~/.local/bin/mcp-cli --version-# mcp-cli v0.3.0-```--### 2. Создайте конфиг--```bash-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-```--### 3. Добавьте токены в shell--```bash-# Добавить в ~/.bashrc-echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc-echo 'export TODOIST_API_KEY="ваш_токен"' >> ~/.bashrc-source ~/.bashrc-```--### 4. Уберите прямое MCP подключение из Claude--```bash-# Удалить прямое MCP подключение-claude mcp remove todoist-```--Проверить что удалено:-```bash-claude mcp list-# todoist НЕ должен быть в списке-```--Теперь Claude работает через mcp-cli (bash), а не через MCP протокол напрямую.-------## Проверка--```bash-# Список инструментов (24 шт)-mcp-cli info todoist--# Тест - задачи на сегодня-mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}'--# Обзор всех проектов-mcp-cli call todoist get-overview '{}'-```-------## Todoist Tools (24)--### Задачи--| Tool | Описание |-|------|----------|-| `add-tasks` | Создать задачи |-| `update-tasks` | Обновить задачи |-| `complete-tasks` | Завершить задачи |-| `find-tasks` | Поиск по тексту/проекту/label |-| `find-tasks-by-date` | Задачи по дате |-| `find-completed-tasks` | Завершённые задачи |--### Проекты и секции--| Tool | Описание |-|------|----------|-| `add-projects` | Создать проекты |-| `update-projects` | Обновить проекты |-| `find-projects` | Поиск проектов |-| `add-sections` | Создать секции |-| `update-sections` | Обновить секции |-| `find-sections` | Секции проекта |--### Комментарии и коллаборация--| Tool | Описание |-|------|----------|-| `add-comments` | Добавить комментарии |-| `update-comments` | Обновить комментарии |-| `find-comments` | Найти комментарии |-| `find-project-collaborators` | Участники проекта |-| `manage-assignments` | Bulk назначение |--### Общее--| Tool | Описание |-|------|----------|-| `get-overview` | Обзор (markdown) |-| `find-activity` | Лог активности |-| `delete-object` | Удалить объект |-| `fetch-object` | Получить объект |-| `user-info` | Инфо о пользователе |-| `search` | Универсальный поиск |-| `fetch` | Получить по ID |-------## Примеры команд--### Задачи на сегодня-```bash-mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}'-```--### Создать задачу-```bash-mcp-cli call todoist add-tasks '{"tasks": [{"content": "Тест задача", "dueString": "tomorrow", "priority": 2}]}'-```--### Завершить задачу-```bash-mcp-cli call todoist complete-tasks '{"ids": ["task_id_here"]}'-```--### Поиск задач-```bash-mcp-cli call todoist find-tasks '{"searchText": "проект"}'-```--### Обзор проекта-```bash-mcp-cli call todoist get-overview '{"projectId": "project_id"}'-```--### Найти проекты-```bash-mcp-cli call todoist find-projects '{"search": "Work"}'-```-------## Отладка--```bash-MCP_DEBUG=1 mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}'-```-------## Требования--- Node.js 18+ (для npx)-- Todoist API Token (Settings → Integrations → Developer)diff --git a/pyproject.toml b/pyproject.tomlindex 822c73b..b528a03 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -1,7 +1,7 @@[project]name = "agent-second-brain"-version = "3.1.0"-description = "Voice-first personal assistant for Telegram with Obsidian and Todoist integration"+version = "3.0.0"+description = "Voice-first personal assistant for Telegram with an Obsidian second brain"readme = "README.md"authors = [{ name = "smixs", email = "[email protected]" }diff --git a/uv.lock b/uv.lockindex 7a1a0b6..6e64618 100644--- a/uv.lock+++ b/uv.lock@@ -4,7 +4,7 @@ requires-python = ">=3.12"[[package]]name = "agent-second-brain"-version = "3.1.0"+version = "3.0.0"source = { editable = "." }dependencies = [{ name = "aiogram" },