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
docs: README reflects v3.0 reality — voice+text input, cron routines
smixs0aca8597e09d
diff --git a/.env.example b/.env.exampleindex d3ba8e0..9e6fda1 100644--- a/.env.example+++ b/.env.example@@ -17,3 +17,7 @@ TZ=UTC# Model for the persistent session. Empty = Claude Code default (Opus).# Set to "sonnet" to reduce weekly-limit pressure for a 24/7 bot.CLAUDE_MODEL=++# Scheduled jobs (the agent manages them itself via the cron skill).+# Defaults are sensible; set CRON_ENABLED=false to turn the ticker off.+CRON_ENABLED=truediff --git a/README.md b/README.mdindex 58184f5..6555585 100644--- a/README.md+++ b/README.md@@ -8,7 +8,7 @@<img alt="Agent Second Brain" src="https://github.com/user-attachments/assets/5b3611d9-11ba-40a1-92fc-8dc78d78d75b" /></p>-**Send a voice note to Telegram. Get an organized knowledge base, completed tasks, and a daily report back.** That's it. That's the whole idea.+**Send a voice note to Telegram. Get an organized knowledge base, scheduled reminders, and a daily report back.** That's it. That's the whole idea.[🇷🇺 Читать на русском](README.ru.md)@@ -24,13 +24,14 @@ The real issue: organizing takes more effort than thinking. So the thinking neve## What this actually does-You talk to a Telegram bot. Voice, text, photos, forwarded messages - whatever is natural. You don't think about categories, tags, or where things go.+You talk to a Telegram bot. Voice or text - whatever is natural. You don't think about categories, tags, or where things go.The agent handles everything else:- **Transcribes** your voice notes (Deepgram, takes seconds)- **Classifies** each entry - task, idea, client note, goal update, random thought- **Saves everything** to an Obsidian vault with proper links and tags+- **Runs your routines** - "remind me in an hour", "every morning at 9 give me a brief" - it schedules its own cron jobs from plain language- **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@@ -92,8 +93,8 @@ You don't run maintenance. The agent does.|----------|-----------|| 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 |+| "Remind me about the call tomorrow at 3pm" | Creates a one-shot scheduled job, pings you in Telegram |+| "Every weekday at 18:30 check my inbox folder" | Creates a recurring job that stays quiet when there's nothing new || "Process" button | Runs the full pipeline right now || "What are my priorities this week?" | Reads your goals, gives you a straight answer |@@ -111,7 +112,7 @@ Each phase produces a clean JSON that the next phase picks up. If something breaTelegram → 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.+**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. Scheduled jobs fire in a second, isolated session, so a reminder going off never blocks your conversation.## What it costs@@ -181,7 +182,7 @@ cd agent-second-brain && bash upgrade.sh```vault/-├── daily/ # Your daily entries (voice, text, photos)+├── daily/ # Your daily entries (voice, text)├── goals/ # Vision → yearly → monthly → weekly├── business/│ ├── crm/ # Client cards@@ -197,12 +198,13 @@ vault/## Skills-The agent has two built-in skills:+The agent has three built-in skills:| Skill | What it does ||-------|-------------|| **dbrain-processor** | Classifies entries, saves notes || **autograph** | Typed vault engine: Ebbinghaus decay, graph health, MOCs, schema-as-code, dedup |+| **cron** | The agent manages its own schedule: reminders, intervals, cron expressions - from plain language |Want just the memory engine? See [autograph](https://github.com/smixs/autograph) - works standalone on any Obsidian vault, no dependencies.diff --git a/README.ru.md b/README.ru.mdindex fa0260e..1e62240 100644--- a/README.ru.md+++ b/README.ru.md@@ -8,7 +8,7 @@<img alt="Agent Second Brain" src="https://github.com/user-attachments/assets/5b3611d9-11ba-40a1-92fc-8dc78d78d75b" /></p>-**Отправь голосовое в Telegram - получи организованную базу знаний, выполненные задачи и дневной отчёт.** Всё. Вся идея в одном предложении.+**Отправь голосовое в Telegram - получи организованную базу знаний, напоминания по расписанию и дневной отчёт.** Всё. Вся идея в одном предложении.[🇬🇧 Read in English](README.md)@@ -24,13 +24,14 @@## Что делает эта штука-Ты пишешь боту в Telegram. Голосовые, текст, фото, пересланные сообщения - как удобно. Не думаешь про категории, теги или куда что положить.+Ты пишешь боту в Telegram. Голосовые или текст - как удобно. Не думаешь про категории, теги или куда что положить.Агент разбирается сам:- **Расшифровывает** голосовые (Deepgram, пара секунд)- **Классифицирует** каждую запись - задача, идея, заметка о клиенте, прогресс по цели, случайная мысль- **Сохраняет всё** в Obsidian-хранилище с правильными ссылками и тегами+- **Ведёт твои рутины** - «напомни через час», «каждое утро в 9 сводка» - сам заводит себе cron-задания из обычной речи- **Присылает дневной отчёт** в 21:00 - что произошло, что сделано, что висит- **Помнит важное, забывает ненужное** - память угасает со временем, как у живого человека@@ -92,8 +93,8 @@ Agent Second Brain использует кривую забывания Эбби|----------------|-------------|| Голосовое о звонке с клиентом | Расшифровывает, создаёт CRM-карточку с follow-up || Текст: «идея для Q2 кампании» | Сохраняет в папку идей, связывает с похожими заметками |-| Пересланная статья из чата | Сохраняет с источником, вытаскивает ключевые мысли |-| Фото доски | Сохраняет с AI-описанием |+| «Напомни про звонок завтра в 15:00» | Создаёт разовое задание по расписанию, пингует в Telegram |+| «По будням в 18:30 проверяй папку inbox» | Создаёт регулярное задание, которое молчит, если ничего нового || Кнопка «Process» | Запускает полный цикл обработки прямо сейчас || «Какие приоритеты на эту неделю?» | Читает цели, даёт прямой ответ |@@ -111,7 +112,7 @@ Agent Second Brain использует кривую забывания ЭббиTelegram → Deepgram → Claude Code → Obsidian → Telegram отчёт```-**Всегда на связи, на твоей подписке.** Бот не запускает новый `claude` на каждое сообщение. Он держит одну живую *интерактивную* сессию Claude Code в tmux-панели и «печатает» в неё твои промпты. Это оставляет его на твоей подписке Claude (интерактивное использование), а не на поштучной оплате API. Watchdog и ежедневная самодиагностика следят за здоровьем сессии круглосуточно и автоматически перезапускают её, если она зависнет - бот просто остаётся живым.+**Всегда на связи, на твоей подписке.** Бот не запускает новый `claude` на каждое сообщение. Он держит одну живую *интерактивную* сессию Claude Code в tmux-панели и «печатает» в неё твои промпты. Это оставляет его на твоей подписке Claude (интерактивное использование), а не на поштучной оплате API. Watchdog и ежедневная самодиагностика следят за здоровьем сессии круглосуточно и автоматически перезапускают её, если она зависнет - бот просто остаётся живым. Задания по расписанию исполняются во второй, изолированной сессии - сработавшее напоминание никогда не блокирует твой разговор.## Сколько стоит@@ -181,7 +182,7 @@ cd agent-second-brain && bash upgrade.sh```vault/-├── daily/ # Дневные записи (голосовые, текст, фото)+├── daily/ # Дневные записи (голосовые, текст)├── goals/ # Видение → год → месяц → неделя├── business/│ ├── crm/ # Карточки клиентов@@ -199,8 +200,9 @@ vault/| Навык | Что делает ||-------|-----------|-| **dbrain-processor** | Классифицирует записи, создаёт задачи, сохраняет заметки |+| **dbrain-processor** | Классифицирует записи, сохраняет заметки || **autograph** | Типизированный движок хранилища: память Эббингауза, здоровье графа, MOC, schema-as-code, дедуп |+| **cron** | Агент сам управляет своим расписанием: напоминания, интервалы, cron-выражения - из обычной речи |Нужен только движок памяти? Смотри [autograph](https://github.com/smixs/autograph) - работает на любом Obsidian-хранилище, без зависимостей.