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.

docs: README reflects v3.0 reality — voice+text input, cron routines

smixs0aca8597e09d
diff --git a/.env.example b/.env.example
index 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=true
diff --git a/README.md b/README.md
index 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 brea
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.
+**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.md
index 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-хранилище, без зависимостей.