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: clarify that restarting the bot does not recreate the brain

smixs8afe32e198b5
diff --git a/README.md b/README.md
index e907b9d..4384bde 100644
--- a/README.md
+++ b/README.md
@@ -215,6 +215,12 @@ All secrets stay in `.env` (gitignored, chmod 600). Set `CLAUDE_MODEL=sonnet` to
Set `TZ` to your own IANA timezone (e.g. `TZ=Europe/Moscow`) — it defaults to `UTC`, and reminders/schedules are interpreted in it. The cron skill's examples use placeholders, not a fixed zone, so the brain schedules in *your* time.
+> **`dbrain restart` does not recreate the brain.** It restarts the bot process; the long-lived Claude Code tmux session deliberately survives (`KillMode=process`) — that's what keeps you on the subscription. Settings read only at session creation (`CLAUDE_MODEL`, `mcp-config.json`, the system prompt) therefore take effect only after the brain is recreated. Kill **both** sessions — the main one and the cron brain (`${brain}_cron`, where reminders run with the same settings) — and the bot rebuilds them on the next message/job:
+> ```bash
+> B="$(cat ~/.dbrain/brain.name)"; tmux kill-session -t "$B"; tmux kill-session -t "${B}_cron" 2>/dev/null
+> ```
+> Bot-level `.env` changes (tokens, `ALLOWED_USER_IDS`, `TZ`) apply on a plain restart.
+
## What it does NOT do
- It does **not** send your vault anywhere. Plain markdown, your disk, your git remote if you configure one.
diff --git a/docs/setup-guide.ru.md b/docs/setup-guide.ru.md
index 3e38df9..44e1f21 100644
--- a/docs/setup-guide.ru.md
+++ b/docs/setup-guide.ru.md
@@ -1091,11 +1091,20 @@ TZ=Europe/Moscow
Опционально: `CLAUDE_MODEL=sonnet` — переключить сессию на Sonnet, если упираетесь в недельные лимиты подписки; `CRON_ENABLED=false` — выключить планировщик напоминаний.
+> **Важно: `dbrain restart` ≠ пересоздание мозга.** Перезапуск перезапускает только Python-процесс бота; долгоживущая сессия Claude Code в tmux при этом **сознательно выживает** (`KillMode=process`) — именно она держит вас на подписке, а не на платных токенах. Поэтому настройки, которые читаются только при СОЗДАНИИ сессии — `CLAUDE_MODEL`, `mcp-config.json`, системный промпт — после простого `dbrain restart` НЕ применятся. Чтобы они вступили в силу, пересоздайте мозг — **обе сессии**: основную и cron (напоминания крутятся во второй сессии `${brain}_cron` с теми же настройками):
+> ```bash
+> B="$(cat ~/.dbrain/brain.name)"
+> tmux kill-session -t "$B" # основной мозг
+> tmux kill-session -t "${B}_cron" 2>/dev/null # cron-мозг (может ещё не существовать)
+> # бот поднимет новые сессии при следующем сообщении / cron-запуске
+> ```
+> (Изменения в `.env` для самого бота — токены, `ALLOWED_USER_IDS`, `TZ`, `CRON_ENABLED` — наоборот, применяются обычным `dbrain restart`.)
+
### MCP-серверы
Система поддерживает **MCP (Model Context Protocol)** — открытый стандарт от Anthropic для подключения AI к внешним сервисам. Хотите, чтобы агент умел работать с вашей почтой, календарём или заметками в других сервисах — подключите соответствующий MCP-сервер.
-Как подключить: положите файл `mcp-config.json` в корень проекта (`~/projects/agent-second-brain/mcp-config.json`) — сессия подхватит его при следующем старте (он передаётся в Claude Code через `--mcp-config`). После добавления перезапустите: `dbrain restart`.
+Как подключить: положите файл `mcp-config.json` в корень проекта (`~/projects/agent-second-brain/mcp-config.json`) — он передаётся в Claude Code через `--mcp-config` при СОЗДАНИИ сессии. Поэтому простого `dbrain restart` недостаточно (мозг переживает рестарт): после добавления **пересоздайте мозг** — см. врезку про `tmux kill-session` выше.
Примеры серверов: