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(release): v3.0 narrative — new README (EN/RU), full Russian setup guide
smixsb5efe31fa4d3
diff --git a/README.md b/README.mdindex 73bcabb..46cd5f4 100644--- a/README.md+++ b/README.md@@ -1,232 +1,232 @@-# Agent Second Brain--[](LICENSE)-[](https://github.com/smixs/agent-second-brain/stargazers)-[](https://github.com/smixs/agent-second-brain/forks)-<p align="center"><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, scheduled reminders, and a daily report back.** That's it. That's the whole idea.+<h1 align="center">Agent Second Brain</h1>-[🇷🇺 Читать на русском](README.ru.md)+<p align="center"><b>An always-on second brain you talk to.</b><br/>+Voice note in Telegram → typed, linked knowledge in your Obsidian vault.<br/>+Runs 24/7 on a $5 VPS and the Claude subscription you already pay for — zero per-token API bills.</p>------## The problem+<p align="center">+ <a href="README.ru.md">🇷🇺 Русский</a> •+ <a href="docs/setup-guide.ru.md">Полная инструкция</a> •+ <a href="docs/vps-setup.md">VPS guide</a> •+ <a href="https://github.com/smixs/autograph">autograph engine</a>+</p>-Every productivity system dies the same way. You set it up on a Sunday, use it for two weeks, then slowly stop because the overhead of maintaining it is more work than the work itself.+<p align="center">+ <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg"></a>+ <img alt="Python 3.12+" src="https://img.shields.io/badge/python-3.12+-blue.svg">+ <a href="https://github.com/smixs/agent-second-brain/stargazers"><img alt="Stars" src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2Fsmixs%2Fagent-second-brain&query=%24.stargazers_count&label=stars&logo=github&color=blue"></a>+ <a href="https://github.com/smixs/agent-second-brain/forks"><img alt="Forks" src="https://img.shields.io/github/forks/smixs/agent-second-brain?style=flat&logo=github"></a>+</p>-You have notes everywhere. Voice memos you never re-listen to. Ideas that disappear into chat history. Tasks you forget to write down. And even when you do capture something, it sits in a folder you'll never open again.+----The real issue: organizing takes more effort than thinking. So the thinking never gets organized.+> [!IMPORTANT]+> **Since June 15, 2026, headless `claude -p` runs bill against a separate paid Agent SDK credit.** v3.0 sidesteps that completely: it drives one long-lived *interactive* Claude Code session — the same thing you run in a terminal, used exactly the way the subscription is meant to be used. No headless calls in the hot path (enforced by a CI guard), no per-request billing, no surprise invoice.-## What this actually does+## Start here-You talk to a Telegram bot. Voice, text, photos, files, forwarded posts - whatever is natural. You don't think about categories, tags, or where things go.+| You want to… | Go to |+|---|---|+| Understand what this thing is | [Why I built this](#why-i-built-this) |+| Install it on a fresh VPS in one command | [Quick start](#quick-start) |+| Upgrade an existing v1 / v2 install | [Upgrading](#upgrading-from-v1--v2) |+| Пошаговая инструкция на русском, для новичков | [docs/setup-guide.ru.md](docs/setup-guide.ru.md) |+| Just want the memory engine for your own vault | [autograph →](https://github.com/smixs/autograph) |+| See how the persistent-session trick works | [How it works](#how-it-works) |-The agent handles everything else:+## Why I built this-- **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+Every productivity system dies the same way. You set it up on a Sunday, use it for two weeks, then slowly stop — because maintaining the system is more work than the work itself. Voice memos you never re-listen to. Ideas that drown in chat history. A vault of markdown files that nobody, including you, can navigate a month later.-The bot runs 24/7 on a $5 VPS. You don't maintain it. You just talk to it.+The fix isn't another app. It's removing the organizing step entirely: **you talk, the agent files**. And it has to be *yours* — I wasn't going to pipe my private notes, clients, and goals through somebody's SaaS. Everything here runs on your own server, lands in your own Obsidian vault as plain markdown, and is small enough to actually read before you trust it with your life.-## Talk to it like a person+## What talking to it looks like-This isn't a button-pressing bot. You have a conversation.+```+You (voice, 40s, while walking): «Созвон с Алишером — они согласны на пилот,+ но просят сдвинуть старт на июль. Надо обновить КП и напомнить мне+ в пятницу отправить договор.»-> **You:** what did I write about the marketing project last week?->-> **Bot:** *finds and shows relevant entries*->-> **You:** turn the second idea into a project note with next steps->-> **Bot:** *creates the note, links it to related entries*->-> **You:** actually add a step for the presentation->-> **Bot:** *updates the note*+Bot: 💾 Сохранил: CRM-карточка Алишера обновлена (пилот, старт июль),+ связал с [[proekt-pilot]]. Напоминание поставлено: пятница 10:00 —+ отправить договор.-It has access to your entire vault and all your goals. Ask it anything about your own notes, and it'll find the answer.+ — Friday, 10:00 —-## Memory that works like memory+Bot: 🔔 Напоминание: отправить договор Алишеру. Контекст: пилот, старт июль,+ КП обновлено во вторник.+```-Most AI systems either remember everything forever (drowning you in noise) or forget everything between sessions.+```+You: what did I write about the marketing project last week?+Bot: *finds the entries, quotes them, links the cards*+You: turn the second idea into a project note with next steps+Bot: *creates the note, links it to the client and this week's goals*+```-Agent Second Brain uses the Ebbinghaus forgetting curve - the same model that describes how human memory works. Every piece of information starts strong and gradually fades unless you access it again.+```+You: *forwards a post, drops a photo of a whiteboard, sends a PDF*+Bot: *reads them itself — files the takeaways into the graph, answers what it saved*+```-Five tiers, from always-on to nearly forgotten:+No commands to memorize, no categories to pick, no app to open. Telegram is the whole interface.-| Tier | What happens |-|------|-------------|-| **Core** | Always in context. Your current projects, active clients, key goals. |-| **Active** | Checked regularly. Recent ideas, ongoing conversations. |-| **Warm** | Found when you search. Last month's notes, past decisions. |-| **Cold** | Only surfaces in deep searches. Old projects, archived plans. |-| **Archive** | Almost gone - but sometimes randomly recalled for creative connections. |+## Philosophy-The archive tier is the interesting one. Occasionally, the agent pulls a random old memory and connects it to something current. Sometimes it's noise. Sometimes it's the best idea you forgot you had.+**Voice-first.** Capture has to be cheaper than forgetting, or the system dies. A voice note costs five seconds.-## Vault health - your notes maintain themselves+**The vault is the source of truth.** Everything lives as plain markdown in *your* Obsidian vault on *your* server. Delete the agent tomorrow — you keep everything, readable forever. No lock-in, no export button needed.-Over time, note systems rot. Links break. Files become orphans. Tags diverge. You end up with a graveyard of markdown files that nobody, including you, can navigate.+**Memory that forgets, like yours.** Storage is not memory. Knowledge decays on the Ebbinghaus curve, fades through five tiers, and resurfaces when it matters — so the graph stays sharp instead of becoming a landfill.-The vault health engine (autograph) runs automatically:+**Interactive session, by the rules.** One persistent Claude Code session in tmux, driven the way a human drives it. No headless `claude -p` anywhere in the hot path — a CI guard fails the build if anyone tries.-- Scores your vault on a 100-point scale-- Finds orphan notes (no links in or out) and suggests connections-- Repairs broken wiki-links-- Generates Maps of Content (MOCs) for each domain-- Flags files missing descriptions+**Small enough to read.** One Python process, a handful of modules, 220+ tests. You can audit the thing that reads your private notes in an evening.-You don't run maintenance. The agent does.+## What it does-## What you send, what happens+<table>+<tr><td><b>🎙 Total capture</b></td><td>Voice (Deepgram, seconds), text, photos, documents, videos, forwarded posts, whole albums — the agent reads files itself and files the takeaways. Nothing you send is ever silently dropped.</td></tr>+<tr><td><b>🧠 Knowledge graph memory</b></td><td>Powered by <a href="https://github.com/smixs/autograph">autograph</a>: typed cards, wiki-links, Ebbinghaus decay across five tiers, automatic MOC indexes, health scoring, link repair, dedup. The most thorough open-source memory layer you can drop on a vault.</td></tr>+<tr><td><b>⏰ Self-managed routines</b></td><td>"Remind me Friday at 3pm", "every weekday at 18:30 check my inbox folder" — the agent schedules its own cron jobs from plain language. One-shots, intervals, full cron expressions. No external task manager.</td></tr>+<tr><td><b>🌙 Nightly processing</b></td><td>At 21:00 your time it classifies the day's entries, writes vault cards, updates goals and long-term memory, rebuilds the graph — and sends you a daily report.</td></tr>+<tr><td><b>🔌 Claude Code, but for PKM</b></td><td>It IS Claude Code under the hood — so drop any MCP server into <code>mcp-config.json</code>, add any skill into <code>vault/.claude/skills/</code>, and your second brain grows new abilities. Like Claude Code through Telegram — for knowledge, not code.</td></tr>+<tr><td><b>🩺 Self-healing</b></td><td>A watchdog recovers a wedged session, a daily doctor sends a 🟢/🔴 canary report, broken jobs disable themselves and tell you. It just stays up.</td></tr>+</table>-| You send | 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 post or a photo of a whiteboard | Saves the file to the vault, the agent reads it and files the takeaways |-| "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 |+## The memory engine: autograph-## How it works (for the curious)+The part that makes this a *brain* rather than a logger is [**autograph**](https://github.com/smixs/autograph) — a typed memory layer for always-on agents, shipped here as a skill and also usable standalone on any Obsidian vault.-The daily processing runs in three phases:+- **Typed graph** — every card carries a type (note, contact, project, CRM), a description for retrieval, tags, status; one `schema.json` rules them all+- **Ebbinghaus decay** — strength `1 + ln(access_count)`: each touch slows forgetting; contacts fade in ~100 days, dailies in ~25+- **Five tiers** — core → active → warm → cold → archive; touching a card promotes it back up+- **Random recall** — occasionally an archived card resurfaces next to something current. Sometimes noise. Sometimes the best idea you forgot you had.+- **Self-maintenance** — orphan detection, broken-link repair, dedup into `.trash/`, MOC generation, a 100-point health score. You never run vault chores again.-1. **Capture** - reads today's entries, classifies each one (task? idea? CRM update? goal progress?)-2. **Execute** - writes vault files, updates cards-3. **Reflect** - generates a summary report, updates long-term memory, sends it to Telegram+| Tier | What happens |+|------|-------------|+| **Core** | Always in context: current projects, active clients, key goals |+| **Active** | Checked regularly: recent ideas, ongoing threads |+| **Warm** | Found when you search |+| **Cold** | Surfaces only in deep searches |+| **Archive** | Almost gone — but randomly recalled for creative collisions |-Each phase produces a clean JSON that the next phase picks up. If something breaks, you can see exactly where and why.+## How it works```-Telegram → Deepgram → Claude Code → Obsidian vault → Telegram report+Telegram ──▶ bot (aiogram) ──▶ persistent Claude Code session (tmux pane)+ │ │+ │ ├──▶ Obsidian vault (plain markdown)+ │ └──▶ autograph: graph · decay · MOC+ ├──▶ cron ticker ──▶ second isolated session (reminders never block chat)+ └──▶ watchdog + daily doctor (self-healing, 🟢/🔴 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. Scheduled jobs fire in a second, isolated session, so a reminder going off never blocks your conversation.+The bot never spawns `claude` per message. It keeps **one long-lived interactive Claude Code session** alive in a tmux pane and types prompts into it — which is why a 24/7 agent runs on a flat Pro/Max subscription instead of metered API tokens. Scheduled jobs fire in a second, isolated session, so a reminder going off never interrupts your conversation. A cross-process lock serializes everything; a watchdog restarts whatever wedges.++Privacy is explicit: **voice audio** goes to Deepgram for transcription, **text** goes to Anthropic through your subscription, **everything else stays on your server**. The vault never leaves the machine.## What it costs| Service | Cost ||---------|------|| Claude Pro | $20/mo |-| VPS (any cheap one works) | ~$5/mo |-| Deepgram | Free tier ($200 credit) |-| **Total** | **~$25/mo** |--$25/month for a personal assistant that organizes your life, never sleeps, and gets better the more you use it.+| VPS (any cheap one) | ~$5/mo |+| Deepgram | free tier ($200 credit) |+| **Total** | **~$25/mo, flat** |-> **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.+A personal assistant that organizes your life, never sleeps, and gets better the more you use it — for the price of two coffees. And because the session is interactive, the price above *stays* the price: there is no token meter to run away from you.## Quick start-### 1. Fork this repo--Click **Fork** at the top of this page. Make it **private** - it will contain your personal data.--### 2. Clone it--```bash-git clone https://github.com/YOUR_USERNAME/agent-second-brain.git-cd agent-second-brain-```--### 3. Fill in your info+Three steps, ~15 minutes of work (full beginner walkthrough: [🇷🇺 setup-guide](docs/setup-guide.ru.md) / [🇬🇧 vps-setup](docs/vps-setup.md)).-Open these files and replace the placeholders:+**1. Fork this repo** (make the fork **private** — it will contain your life), then fill in `vault/goals/` and the persona in `vault/.claude/skills/dbrain-processor/references/about.md`.-- `vault/goals/` - your vision, yearly goals, monthly priorities, weekly focus-- `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+**2. Get two keys**: a bot token from [@BotFather](https://t.me/BotFather), a free key from [Deepgram](https://console.deepgram.com/), plus your Telegram ID from [@userinfobot](https://t.me/userinfobot).-### 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 |--### 5. Deploy--Follow the [VPS setup guide](docs/vps-setup.md), or run:+**3. On a fresh Ubuntu VPS:**```bash-ssh root@YOUR_SERVER_IPcurl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/agent-second-brain/main/bootstrap.sh | bash```-That's it. The bot starts, you send it a message, and the system is alive.+The installer interviews you for the tokens, walks you through Claude Code login (browser link), installs systemd services, and finishes with a health check. The bot messages you when it's alive. That's it — start talking.++<details>+<summary>What the installer actually does (inspect before you trust)</summary>++`bootstrap.sh` clones your fork and hands off to `setup.sh`, which only asks questions (tokens, timezone, git remote) and writes `.env` (chmod 600). All real work happens in idempotent `upgrade.sh`: uv + Python deps, tmux, Claude CLI, `dbrain-*` systemd user units, a `dbrain` CLI (`status` / `logs` / `attach` / `doctor`), permission hardening, and a first doctor run. Every script is short enough to read first.+</details>-### Already running an older version?+## Upgrading from v1 / v2-Upgrading an existing v2 / v3.0 install to the persistent-session architecture is one idempotent command — it installs tmux, pulls the new code, migrates the systemd services, and runs a health check:+One idempotent command — it migrates old units, installs what's missing, repairs permissions, and health-checks itself:```bashssh your-server-cd agent-second-brain && bash upgrade.sh+cd agent-second-brain && git pull && bash upgrade.sh```----+If a migration ever goes sideways, run `claude` in the project directory and call the **migrate-doctor** skill — it diagnoses the install layout (v1/v2/v3), backs up, and repairs interactively.## Vault structure```vault/-├── daily/ # Your daily entries (voice, text, attachments)+├── daily/ # Your raw daily stream (voice, text, attachments)├── goals/ # Vision → yearly → monthly → weekly├── business/│ ├── crm/ # Client cards│ └── network/ # Professional contacts-├── projects/ # Client work, leads, pipeline+├── projects/ # Active work, leads, pipeline├── thoughts/│ ├── ideas/ # Ideas and brainstorms│ ├── learnings/ # Lessons learned│ └── reflections/ # Personal reflections├── MOC/ # Maps of Content (auto-generated)-└── MEMORY.md # Agent's long-term memory+└── MEMORY.md # The agent's long-term memory```## Skills-The agent has four 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 |+| **dbrain-processor** | Classifies entries, writes vault cards, daily reports |+| **[autograph](https://github.com/smixs/autograph)** | The memory engine: decay, graph health, MOCs, schema-as-code, dedup |+| **cron** | The agent manages its own schedule from plain language || **migrate-doctor** | Diagnoses and repairs broken upgrades from older versions |-Want just the memory engine? See [autograph](https://github.com/smixs/autograph) - works standalone on any Obsidian vault, no dependencies.+Drop your own into `vault/.claude/skills/` — the session picks them up like any Claude Code install.## Configuration-| File | What it controls |-|------|-----------------|-| `.env` | API tokens (copy from `.env.example`) |-| `vault/.claude/CLAUDE.md` | Agent personality and rules |+| File | Controls |+|------|----------|+| `.env` | Tokens, timezone, model, cron tuning (see `.env.example`) |+| `vault/.claude/CLAUDE.md` | The agent's personality and rules |+| `mcp-config.json` | Optional: any MCP servers you want the brain to have |-All secrets stay in `.env`, which is gitignored. Don't commit tokens.+All secrets stay in `.env` (gitignored, chmod 600). Set `CLAUDE_MODEL=sonnet` to reduce weekly-limit pressure on a 24/7 bot.----+## What it does NOT do++- It does **not** send your vault anywhere. Plain markdown, your disk, your git remote if you configure one.+- It does **not** use headless `claude -p` — `scripts/check-no-claude-p.sh` runs in CI and fails the build if that ever changes.+- It does **not** require any API keys beyond Telegram + Deepgram. No OpenAI, no token meter.+- It does **not** lock you in. Delete everything tomorrow; your vault still opens in Obsidian.## Built by-[Serge Shima](https://shima.me) - 20 years in marketing (BBDO, Publicis), now running an AI creative agency in Central Asia and teaching businesses how to work with AI at [aimasters.me](https://aimasters.me).+[Serge Shima](https://shima.me) — 20 years in marketing (BBDO, Publicis), now running an AI creative agency in Central Asia and teaching businesses to work with AI at [aimasters.me](https://aimasters.me).-This system runs my actual life. 1,100+ vault cards, 5 AI agents, daily reports. It started as a weekend project and became infrastructure.+This system runs my actual life: 1,100+ vault cards, daily reports, an agent I argue with about my own calendar. It started as a weekend project and became infrastructure.## License-[MIT](LICENSE) - do whatever you want with it.+[MIT](LICENSE) — do whatever you want with it.diff --git a/README.ru.md b/README.ru.mdindex 2763694..b9359a8 100644--- a/README.ru.md+++ b/README.ru.md@@ -1,119 +1,134 @@-# Agent Second Brain--[](LICENSE)-[](https://github.com/smixs/agent-second-brain/stargazers)-[](https://github.com/smixs/agent-second-brain/forks)-<p align="center"><img alt="Agent Second Brain" src="https://github.com/user-attachments/assets/5b3611d9-11ba-40a1-92fc-8dc78d78d75b" /></p>-**Отправь голосовое в Telegram - получи организованную базу знаний, напоминания по расписанию и дневной отчёт.** Всё. Вся идея в одном предложении.+<h1 align="center">Agent Second Brain</h1>-[🇬🇧 Read in English](README.md)+<p align="center"><b>Всегда включённый второй мозг, с которым разговаривают.</b><br/>+Голосовое в Telegram → структурированное, связанное знание в вашем Obsidian-хранилище.<br/>+Работает 24/7 на VPS за $5 и вашей обычной подписке Claude — ноль счетов за API-токены.</p>------## Проблема+<p align="center">+ <a href="README.md">🇬🇧 English</a> •+ <a href="docs/setup-guide.ru.md">Полная пошаговая инструкция</a> •+ <a href="https://github.com/smixs/autograph">Движок autograph</a>+</p>-Любая система продуктивности умирает одинаково. Настраиваешь в воскресенье, пользуешься две недели, потом бросаешь - потому что поддержка системы отнимает больше сил, чем сама работа.+<p align="center">+ <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg"></a>+ <img alt="Python 3.12+" src="https://img.shields.io/badge/python-3.12+-blue.svg">+ <a href="https://github.com/smixs/agent-second-brain/stargazers"><img alt="Stars" src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2Fsmixs%2Fagent-second-brain&query=%24.stargazers_count&label=stars&logo=github&color=blue"></a>+ <a href="https://github.com/smixs/agent-second-brain/forks"><img alt="Forks" src="https://img.shields.io/github/forks/smixs/agent-second-brain?style=flat&logo=github"></a>+</p>-Заметки раскиданы везде. Голосовые, которые никогда не переслушаешь. Идеи, утонувшие в истории чатов. Задачи, которые забыл записать. А если записал - они лежат в папке, которую ты больше не откроешь.+----Корень проблемы: организовывать сложнее, чем думать. Поэтому мысли остаются неорганизованными.+> [!IMPORTANT]+> **С 15 июня 2026 headless-запуски `claude -p` оплачиваются отдельным Agent SDK-кредитом.** v3.0 полностью обходит это: бот ведёт одну долгоживущую *интерактивную* сессию Claude Code — ровно ту же, что вы запускаете в терминале, ровно так, как подписка и задумана. Никаких headless-вызовов в рабочем контуре (это проверяет CI-гард), никакого пер-запросного биллинга, никаких сюрпризов в счёте.-## Что делает эта штука+## С чего начать-Ты пишешь боту в Telegram. Голосовые, текст, фото, файлы, пересланные посты - как удобно. Не думаешь про категории, теги или куда что положить.+| Вы хотите… | Вам сюда |+|---|---|+| Понять, что это вообще такое | [Зачем я это построил](#зачем-я-это-построил) |+| Поставить на чистый VPS одной командой | [Быстрый старт](#быстрый-старт) |+| Обновить существующую v1 / v2 | [Обновление](#обновление-с-v1--v2) |+| Подробную инструкцию для новичков, шаг за шагом | [docs/setup-guide.ru.md](docs/setup-guide.ru.md) |+| Только движок памяти для своего vault | [autograph →](https://github.com/smixs/autograph) |+| Разобраться, как работает трюк с постоянной сессией | [Как это устроено](#как-это-устроено) |-Агент разбирается сам:+## Зачем я это построил-- **Расшифровывает** голосовые (Deepgram, пара секунд)-- **Классифицирует** каждую запись - задача, идея, заметка о клиенте, прогресс по цели, случайная мысль-- **Сохраняет всё** в Obsidian-хранилище с правильными ссылками и тегами-- **Ведёт твои рутины** - «напомни через час», «каждое утро в 9 сводка» - сам заводит себе cron-задания из обычной речи-- **Присылает дневной отчёт** в 21:00 - что произошло, что сделано, что висит-- **Помнит важное, забывает ненужное** - память угасает со временем, как у живого человека+Все системы продуктивности умирают одинаково. Вы настраиваете её в воскресенье, пользуетесь две недели — и тихо бросаете, потому что обслуживание системы требует больше сил, чем сама работа. Голосовые, которые вы никогда не переслушаете. Идеи, тонущие в истории чатов. Хранилище markdown-файлов, в котором через месяц не ориентируетесь даже вы.-Бот работает 24/7 на сервере за $5. Ты его не обслуживаешь. Ты просто с ним разговариваешь.+Лекарство — не ещё одно приложение. Лекарство — убрать этап «разложить по полочкам» целиком: **вы говорите, агент раскладывает**. И система обязана быть *вашей* — я не собирался прогонять свои заметки, клиентов и цели через чей-то SaaS. Здесь всё крутится на вашем сервере, ложится в ваш Obsidian-vault обычным markdown, а кода достаточно мало, чтобы прочитать его перед тем, как доверить ему свою жизнь.-## Разговаривай как с человеком+## Как выглядит разговор-Это не бот с кнопками. Это разговор.+```+Вы (голосовое, 40 секунд, на ходу): «Созвон с Алишером — они согласны на пилот,+ но просят сдвинуть старт на июль. Надо обновить КП и напомнить мне+ в пятницу отправить договор.»-> **Ты:** что я писал про маркетинговый проект на прошлой неделе?->-> **Бот:** *находит и показывает записи*->-> **Ты:** вторую идею оформи как заметку-проект с следующими шагами->-> **Бот:** *создаёт заметку и связывает её с похожими записями*->-> **Ты:** добавь шаг про презентацию->-> **Бот:** *обновляет заметку*+Бот: 💾 Сохранил: CRM-карточка Алишера обновлена (пилот, старт июль),+ связал с [[proekt-pilot]]. Напоминание поставлено: пятница 10:00 —+ отправить договор.-У агента доступ ко всему хранилищу и всем целям. Спроси что угодно про свои записи - найдёт.+ — пятница, 10:00 —-## Память, которая работает как память+Бот: 🔔 Напоминание: отправить договор Алишеру. Контекст: пилот, старт июль,+ КП обновлено во вторник.+```-Большинство AI-систем либо помнят всё навсегда (утопая в шуме), либо забывают всё между сессиями.+```+Вы: что я писал про маркетинговый проект на прошлой неделе?+Бот: *находит записи, цитирует, показывает связанные карточки*+Вы: преврати вторую идею в проектную заметку с next steps+Бот: *создаёт заметку, связывает с клиентом и целями недели*+```-Agent Second Brain использует кривую забывания Эббингауза - ту же модель, что описывает работу человеческой памяти. Каждая запись начинает с максимальной «яркости» и постепенно тускнеет, если к ней не возвращаются.+```+Вы: *пересылаете пост, кидаете фото доски, отправляете PDF*+Бот: *читает их сам — раскладывает суть по графу и отвечает, что сохранил*+```-Пять уровней - от «всегда под рукой» до «почти забыто»:+Никаких команд, никаких категорий, никакого приложения. Telegram — весь интерфейс.-| Уровень | Что происходит |-|---------|---------------|-| **Ядро** | Всегда в контексте. Текущие проекты, активные клиенты, ключевые цели. |-| **Активные** | Проверяются регулярно. Свежие идеи, текущие разговоры. |-| **Тёплые** | Находятся при поиске. Заметки за прошлый месяц, принятые решения. |-| **Холодные** | Всплывают только при глубоком поиске. Старые проекты, архивные планы. |-| **Архив** | Почти забытые - но иногда случайно вспоминаются для неожиданных связей. |+## Философия-Архив - самое интересное. Иногда агент достаёт случайную старую запись и связывает с чем-то текущим. Бывает - мимо. А бывает - это лучшая идея, которую ты забыл.+**Голос — прежде всего.** Захват мысли должен быть дешевле забывания, иначе система умрёт. Голосовое стоит пять секунд.-## Здоровье хранилища - заметки сами себя чинят+**Vault — источник истины.** Всё лежит обычным markdown в *вашем* Obsidian-хранилище на *вашем* сервере. Удалите агента завтра — всё останется и будет читаться вечно. Никакого lock-in, кнопка «экспорт» не нужна.-Со временем любая система заметок гниёт. Ссылки ломаются. Файлы становятся сиротами. Теги расползаются. В итоге - кладбище маркдаун-файлов, по которому не может пройти никто.+**Память, которая забывает — как ваша.** Хранение — это не память. Знания угасают по кривой Эббингауза, проходят пять уровней и всплывают, когда нужны — граф остаётся острым, а не превращается в свалку.-Система здоровья работает автоматически:+**Интерактивная сессия, по правилам.** Одна постоянная сессия Claude Code в tmux, управляемая так же, как ей управляет человек. Никакого headless `claude -p` в рабочем контуре — CI-гард валит сборку при любой попытке.-- Оценивает хранилище по 100-балльной шкале-- Находит сироты (файлы без связей) и предлагает ссылки-- Чинит сломанные вики-линки-- Генерирует карты содержимого (MOC) для каждой области-- Отмечает файлы без описаний+**Достаточно маленький, чтобы прочитать.** Один Python-процесс, горстка модулей, 220+ тестов. Систему, которая читает ваши личные заметки, можно проаудировать за вечер.-Ты не занимаешься обслуживанием. Агент занимается.+## Что умеет-## Что отправляешь - что получаешь+<table>+<tr><td><b>🎙 Тотальный захват</b></td><td>Голос (Deepgram, секунды), текст, фото, документы, видео, пересланные посты, целые альбомы — агент сам читает файлы и раскладывает суть. Ничто из отправленного не пропадает молча.</td></tr>+<tr><td><b>🧠 Память-граф</b></td><td>На движке <a href="https://github.com/smixs/autograph">autograph</a>: типизированные карточки, wiki-связи, угасание по Эббингаузу через пять уровней, автоматические MOC-индексы, оценка здоровья, починка ссылок, дедупликация. Самый дотошный open-source слой памяти для вашего vault.</td></tr>+<tr><td><b>⏰ Рутины без таск-менеджера</b></td><td>«Напомни в пятницу в 15:00», «каждый будний день в 18:30 проверяй папку inbox» — агент сам заводит себе cron-задания из обычной речи. Разовые, интервалы, полные cron-выражения.</td></tr>+<tr><td><b>🌙 Ночная обработка</b></td><td>В 21:00 по вашему времени он классифицирует записи дня, пишет карточки, обновляет цели и долгую память, перестраивает граф — и присылает дневной отчёт.</td></tr>+<tr><td><b>🔌 Claude Code, но для PKM</b></td><td>Под капотом это и ЕСТЬ Claude Code — подключайте любой MCP-сервер через <code>mcp-config.json</code>, кладите любой скилл в <code>vault/.claude/skills/</code> — и второй мозг получает новые способности. Как Claude Code через Telegram — только для знаний, а не для кода.</td></tr>+<tr><td><b>🩺 Самолечение</b></td><td>Watchdog поднимает зависшую сессию, ежедневный doctor шлёт 🟢/🔴 отчёт-канарейку, сломанные задания отключают сами себя и сообщают вам. Оно просто продолжает работать.</td></tr>+</table>-| Ты отправляешь | Агент делает |-|----------------|-------------|-| Голосовое о звонке с клиентом | Расшифровывает, создаёт CRM-карточку с follow-up |-| Текст: «идея для Q2 кампании» | Сохраняет в папку идей, связывает с похожими заметками |-| Пересланный пост или фото доски | Сохраняет файл в хранилище, агент сам читает его и раскладывает суть |-| «Напомни про звонок завтра в 15:00» | Создаёт разовое задание по расписанию, пингует в Telegram |-| «По будням в 18:30 проверяй папку inbox» | Создаёт регулярное задание, которое молчит, если ничего нового |-| Кнопка «Process» | Запускает полный цикл обработки прямо сейчас |-| «Какие приоритеты на эту неделю?» | Читает цели, даёт прямой ответ |+## Движок памяти: autograph-## Как это работает (для любопытных)+То, что делает эту систему *мозгом*, а не логгером — [**autograph**](https://github.com/smixs/autograph): типизированный слой памяти для always-on агентов. Здесь он поставляется как скилл, но работает и отдельно, на любом Obsidian-vault.-Ежедневная обработка идёт в три фазы:+- **Типизированный граф** — у каждой карточки тип (заметка, контакт, проект, CRM), description для поиска, теги, статус; всем правит один `schema.json`+- **Угасание по Эббингаузу** — сила памяти `1 + ln(число_обращений)`: каждое касание замедляет забывание; контакты живут ~100 дней, дневные записи ~25+- **Пять уровней** — core → active → warm → cold → archive; касание поднимает карточку обратно+- **Случайные воспоминания** — иногда архивная карточка всплывает рядом с текущей задачей. Иногда это шум. Иногда — лучшая идея, которую вы забыли.+- **Самообслуживание** — поиск сирот, починка битых ссылок, дедуп в `.trash/`, генерация MOC, здоровье графа по 100-балльной шкале. Вы больше не делаете уборку в заметках.-1. **Захват** - читает записи за день, классифицирует каждую (задача? идея? обновление CRM? прогресс по цели?)-2. **Исполнение** - пишет файлы в хранилище, обновляет карточки-3. **Рефлексия** - генерирует сводный отчёт, обновляет долговременную память, отправляет в Telegram+| Уровень | Что происходит |+|---------|----------------|+| **Core** | Всегда в контексте: текущие проекты, активные клиенты, ключевые цели |+| **Active** | Проверяется регулярно: свежие идеи, живые треды |+| **Warm** | Находится при поиске |+| **Cold** | Всплывает только в глубоком поиске |+| **Archive** | Почти забыто — но иногда случайно вспоминается для творческих коллизий |-Каждая фаза создаёт чистый JSON, который подхватывает следующая. Если что-то ломается - видно где именно и почему.+## Как это устроено```-Telegram → Deepgram → Claude Code → Obsidian → Telegram отчёт+Telegram ──▶ бот (aiogram) ──▶ постоянная сессия Claude Code (tmux)+ │ │+ │ ├──▶ Obsidian vault (обычный markdown)+ │ └──▶ autograph: граф · угасание · MOC+ ├──▶ cron-тикер ──▶ вторая изолированная сессия (напоминания не блокируют чат)+ └──▶ watchdog + ежедневный doctor (самолечение, 🟢/🔴 отчёт)```-**Всегда на связи, на твоей подписке.** Бот не запускает новый `claude` на каждое сообщение. Он держит одну живую *интерактивную* сессию Claude Code в tmux-панели и «печатает» в неё твои промпты. Это оставляет его на твоей подписке Claude (интерактивное использование), а не на поштучной оплате API. Watchdog и ежедневная самодиагностика следят за здоровьем сессии круглосуточно и автоматически перезапускают её, если она зависнет - бот просто остаётся живым. Задания по расписанию исполняются во второй, изолированной сессии - сработавшее напоминание никогда не блокирует твой разговор.+Бот не запускает `claude` на каждое сообщение. Он держит **одну долгоживущую интерактивную сессию Claude Code** в tmux-панели и «печатает» в неё промпты — поэтому агент 24/7 живёт на фиксированной подписке Pro/Max, а не на счётчике API-токенов. Плановые задания исполняются во второй, изолированной сессии — сработавшее напоминание никогда не перебивает ваш разговор. Межпроцессный лок сериализует доступ; watchdog перезапускает всё, что зависло.++Приватность — явная: **аудио голосовых** уходит в Deepgram на расшифровку, **текст** уходит в Anthropic через вашу подписку, **всё остальное остаётся на вашем сервере**. Vault не покидает машину.## Сколько стоит@@ -121,110 +136,96 @@ Telegram → Deepgram → Claude Code → Obsidian → Telegram отчёт|--------|------|| Claude Pro | $20/мес || VPS (любой дешёвый) | ~$5/мес |-| Deepgram | Бесплатно ($200 кредит) |-| **Итого** | **~$25/мес** |--$25 в месяц за личного ассистента, который организует твою жизнь, никогда не спит и становится лучше с каждым днём использования.+| Deepgram | бесплатный tier ($200 кредита) |+| **Итого** | **~$25/мес, фиксированно** |-> **Почему это важно (июнь 2026).** С 15 июня 2026 Anthropic переводит `claude -p` / headless-запуски на отдельный платный кредит Agent SDK с поштучной оплатой. Agent Second Brain **v3.0** обходит это полностью: он гоняет постоянную *интерактивную* сессию, которая остаётся на твоей фиксированной подписке Pro/Max. Никакой поштучной оплаты и неожиданных счетов - цена выше остаётся ценой.+Личный ассистент, который раскладывает вашу жизнь по полочкам, никогда не спит и становится лучше с каждым днём — по цене двух чашек кофе. И поскольку сессия интерактивная, эта цена *остаётся* ценой: здесь нет токен-счётчика, который может убежать.## Быстрый старт-### 1. Форкни репо--Нажми **Fork** вверху страницы. Сделай форк **приватным** - в нём будут твои личные данные.--### 2. Склонируй--```bash-git clone https://github.com/YOUR_USERNAME/agent-second-brain.git-cd agent-second-brain-```--### 3. Заполни свою информацию+Три шага, ~15 минут работы. Полная инструкция для новичков — [docs/setup-guide.ru.md](docs/setup-guide.ru.md).-Открой эти файлы и замени шаблоны на свои данные:+**1. Сделайте Fork репозитория** (форк — **приватный**, в нём будет ваша жизнь), заполните `vault/goals/` и профиль в `vault/.claude/skills/dbrain-processor/references/about.md`.-- `vault/goals/` - видение, годовые цели, месячные приоритеты, фокус недели-- `vault/.claude/skills/dbrain-processor/references/about.md` - расскажи агенту о себе-- `vault/.claude/skills/dbrain-processor/references/classification.md` - как сортировать записи+**2. Получите два ключа**: токен бота у [@BotFather](https://t.me/BotFather), бесплатный ключ на [Deepgram](https://console.deepgram.com/), плюс свой Telegram ID у [@userinfobot](https://t.me/userinfobot).-### 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 мин |--### 5. Разверни--Следуй [инструкции по настройке VPS](docs/vps-setup.md), или:+**3. На чистом Ubuntu VPS:**```bash-ssh root@YOUR_SERVER_IPcurl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/agent-second-brain/main/bootstrap.sh | bash```-Бот запускается, ты отправляешь ему сообщение - система живёт.+Установщик спросит токены, проведёт через вход в Claude Code (ссылка в браузере), поставит systemd-сервисы и закончит health-check'ом. Бот напишет вам, когда оживёт. Всё — начинайте разговаривать.++<details>+<summary>Что установщик делает на самом деле (проверьте, прежде чем доверять)</summary>-### Уже стоит старая версия?+`bootstrap.sh` клонирует ваш форк и передаёт управление `setup.sh`, который только задаёт вопросы (токены, таймзона, git remote) и пишет `.env` (chmod 600). Вся настоящая работа — в идемпотентном `upgrade.sh`: uv и Python-зависимости, tmux, Claude CLI, systemd-юниты `dbrain-*`, CLI-команда `dbrain` (`status` / `logs` / `attach` / `doctor`), затяжка прав доступа и первый прогон doctor. Каждый скрипт достаточно короткий, чтобы прочитать его заранее.+</details>-Обновление существующей установки v2 / v3.0 на архитектуру с постоянной сессией - одна идемпотентная команда: ставит tmux, тянет новый код, мигрирует systemd-сервисы и прогоняет health-check:+## Обновление с v1 / v2++Одна идемпотентная команда — мигрирует старые юниты, доставит недостающее, починит права и сама себя проверит:```bash-ssh your-server-cd agent-second-brain && bash upgrade.sh+ssh ваш-сервер+cd agent-second-brain && git pull && bash upgrade.sh```----+Если миграция пошла не так — запустите `claude` в директории проекта и позовите скилл **migrate-doctor**: он определит раскладку (v1/v2/v3), сделает бэкап и интерактивно починит.-## Структура хранилища+## Структура vault```vault/-├── daily/ # Дневные записи (голосовые, текст, вложения)+├── daily/ # Сырой поток дня (голос, текст, вложения)├── goals/ # Видение → год → месяц → неделя├── business/│ ├── crm/ # Карточки клиентов│ └── network/ # Профессиональные контакты-├── projects/ # Клиентские проекты, лиды, пайплайн+├── projects/ # Активная работа, лиды, пайплайн├── thoughts/-│ ├── ideas/ # Идеи и мозговые штурмы-│ ├── learnings/ # Уроки-│ └── reflections/ # Рефлексии-├── MOC/ # Карты содержимого (генерируются автоматически)-└── MEMORY.md # Долговременная память агента+│ ├── ideas/ # Идеи и брейнштормы+│ ├── learnings/ # Выученные уроки+│ └── reflections/ # Личные рефлексии+├── MOC/ # Карты контента (генерируются автоматически)+└── MEMORY.md # Долгая память агента```-## Навыки агента+## Навыки| Навык | Что делает ||-------|-----------|-| **dbrain-processor** | Классифицирует записи, сохраняет заметки |-| **autograph** | Типизированный движок хранилища: память Эббингауза, здоровье графа, MOC, schema-as-code, дедуп |-| **cron** | Агент сам управляет своим расписанием: напоминания, интервалы, cron-выражения - из обычной речи |-| **migrate-doctor** | Диагностирует и чинит сломанные обновления с прошлых версий |+| **dbrain-processor** | Классифицирует записи, пишет карточки, дневные отчёты |+| **[autograph](https://github.com/smixs/autograph)** | Движок памяти: угасание, здоровье графа, MOC, schema-as-code, дедуп |+| **cron** | Агент сам управляет своим расписанием из обычной речи |+| **migrate-doctor** | Диагностирует и чинит сломанные обновления со старых версий |-Нужен только движок памяти? Смотри [autograph](https://github.com/smixs/autograph) - работает на любом Obsidian-хранилище, без зависимостей.+Кладите свои в `vault/.claude/skills/` — сессия подхватит их, как любой Claude Code.## Конфигурация| Файл | За что отвечает |-|------|----------------|-| `.env` | API-токены (скопируй из `.env.example`) |+|------|-----------------|+| `.env` | Токены, таймзона, модель, тюнинг cron (см. `.env.example`) || `vault/.claude/CLAUDE.md` | Личность и правила агента |+| `mcp-config.json` | Опционально: любые MCP-серверы для мозга |-Все секреты в `.env`, который в gitignore. Не коммить токены.+Все секреты — в `.env` (gitignore, chmod 600). Поставьте `CLAUDE_MODEL=sonnet`, чтобы снизить расход недельного лимита у 24/7-бота.----+## Чего система НЕ делает++- **Не** отправляет ваш vault никуда. Обычный markdown, ваш диск, ваш git remote — если вы его настроите.+- **Не** использует headless `claude -p` — `scripts/check-no-claude-p.sh` гоняется в CI и валит сборку, если это изменится.+- **Не** требует никаких ключей, кроме Telegram и Deepgram. Без OpenAI, без токен-счётчика.+- **Не** запирает вас. Удалите всё завтра — vault так же откроется в Obsidian.-## Кто сделал+## Автор-[Сергей Шима](https://shima.me) - 20 лет в маркетинге (BBDO, Publicis), сейчас руководит AI-креативным агентством в Центральной Азии и учит бизнес работать с AI на [aimasters.me](https://aimasters.me).+[Серж Шима](https://shima.me) — 20 лет в маркетинге (BBDO, Publicis), сейчас — AI-креативное агентство в Центральной Азии и обучение бизнеса работе с AI на [aimasters.me](https://aimasters.me).-Эта система работает в моей реальной жизни. 1,100+ карточек в хранилище, 5 AI-агентов, ежедневные отчёты. Начиналось как проект на выходных - стало инфраструктурой.+Эта система ведёт мою реальную жизнь: 1100+ карточек в vault, дневные отчёты и агент, с которым я спорю о собственном календаре. Начиналось как проект на выходные — стало инфраструктурой.## Лицензия-[MIT](LICENSE) - делай с этим что хочешь.+[MIT](LICENSE) — делайте что хотите.diff --git a/docs/setup-guide.ru.md b/docs/setup-guide.ru.mdnew file mode 100644index 0000000..3e38df9--- /dev/null+++ b/docs/setup-guide.ru.md@@ -0,0 +1,1212 @@+# Agent Second Brain — полная инструкция по установке (v3.0)++<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>++**Персональный 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) |+| **Приватность** | **Это ваш личный сервер. Никто, кроме вас, не имеет доступа к вашим мыслям и задачам.** |++> **Что изменилось в версии 3.0 (если коротко):**+> - Установка стала сильно проще: одна команда запускает скрипт, который сам ставит всё необходимое и сам задаёт вам вопросы.+> - Ключей нужно меньше: всего два (Telegram и Deepgram) плюс ваш Telegram ID.+> - Напоминания и расписания агент теперь делает сам — никаких внешних таск-менеджеров подключать не нужно.+> - Внутри теперь живёт одна постоянная сессия Claude Code — она работает на вашей обычной подписке Claude Pro/Max.++---++## Оглавление++- [Зачем это нужно](#зачем-это-нужно)+- [Как это работает](#как-это-работает)+- [Словарь терминов](#словарь-терминов)+- [Что понадобится](#что-понадобится)+- **Часть 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: Получите ключи** ⏱ 10 мин+ - [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)+- **Часть 3: Настройка сервера** ⏱ 30–50 мин+ - [3.1 Купите VPS и подключитесь](#31-купите-vps-и-подключитесь)+ - [3.2 Создайте пользователя](#32-создайте-пользователя)+ - [3.3 Запустите установку (одна команда)](#33-запустите-установку-одна-команда)+ - [3.4 Авторизуйте Claude Code](#34-авторизуйте-claude-code)+- [Часть 4: Использование](#часть-4-использование)+- [Часть 5: Синхронизация](#часть-5-синхронизация)+- [Обновление с прошлых версий](#обновление-с-прошлых-версий)+- [Помощь](#помощь)++---++## Зачем это нужно++Это система управления мыслями, заметками и напоминаниями «на стероидах». Один раз настроите — и у вас всегда под рукой понимание, что происходит в жизни.++**Кидайте туда вообще всё:**+- Интересные посты из Telegram — пересылайте боту+- Скриншоты — отправляйте+- После встречи — надиктуйте голосом что было и какие решения+- Эмоции, мысли, идеи — всё записывайте+- Ссылки, цитаты, заметки — абсолютно всё++### Самое крутое — с ним можно просто разговаривать++Это **полноценный AI-агент**. В версии 3.0 не нужно нажимать никаких специальных кнопок — просто пишете или наговариваете боту что угодно, и он сам разберётся что делать.++**Примеры того, что можно попросить:**++| Запрос | Что сделает агент |+|--------|-------------------|+| «Найди ту идею про маркетинг, которую я записывал на прошлой неделе» | Найдёт в ваших заметках и покажет |+| «Что я делал вчера?» | Даст отчёт по вчерашним записям |+| «Напомни через час про звонок» | Поставит себе напоминание и напишет вам через час |+| «Каждое утро в 9 — сводка дня» | Создаст повторяющееся расписание и будет присылать сводку сам |+| «Обнови мои недельные цели» | Откроет файл целей и поможет обновить |+| «Что у меня в приоритетах на этой неделе?» | Прочитает ваши цели и ответит по делу |+| «Посоветуй, на чём сфокусироваться сегодня» | Проанализирует цели и записи, даст совет |++Вы общаетесь с ним как с настоящим ассистентом. Он сам найдёт нужные файлы, обновит структуру, поставит напоминание — всё автоматически. Никаких внешних таск-менеджеров: напоминания и расписания агент создаёт сам себе, встроенным планировщиком.++---++Чем больше вы делитесь информацией и чем лучше заполните цели и карточку о себе — тем лучше агент понимает ваш контекст и тем точнее расставляет приоритеты.++**Про Claude Code — не бойтесь названия.** Да, он называется «Code», но это универсальный AI-агент, который отлично помогает в жизни. У него чёткие инструкции как действовать с вашими записями — сохранять мысли, следить за целями, напоминать о важном. Он просто работает.++---++> **Если вы запутались на каком-то шаге**+>+> Не переживайте! Откройте [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) и напишите:+> «Помоги разобраться с этой инструкцией, я застрял на шаге [номер шага]. Вот ссылка: https://github.com/ВАШ_ЛОГИН/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. Мысли и заметки сохраняются в **Obsidian**-хранилище, напоминания агент ставит себе сам+5. Вечером в 21:00 агент обрабатывает все записи за день и присылает отчёт в **Telegram**+6. Всё синхронизируется в **GitHub**++### Что значит «постоянная сессия» (и почему это важно)++В прошлых версиях бот на каждое сообщение запускал отдельную копию Claude — как если бы вы для каждого вопроса нанимали нового ассистента, объясняли ему всё с нуля, а потом увольняли.++В версии 3.0 на сервере живёт **одна постоянная, открытая сессия Claude Code** — тот же интерактивный Claude Code, который разработчики запускают у себя в терминале. Бот просто «печатает» ваши сообщения в это открытое окно и забирает ответы. Окно никогда не закрывается: его держит программа `tmux` (см. словарь ниже), а специальный сторож-процесс следит, чтобы сессия была живой, и перезапускает её, если что-то пошло не так.++**Почему это здорово:**+- Работает на обычной подписке **Claude Pro или Max** — это интерактивное использование Claude Code, полностью по правилам подписки. Никакой оплаты за каждый запрос.+- Агент помнит контекст разговора: можно сказать «а теперь добавь туда ещё один пункт» — и он поймёт, о чём речь.+- Напоминания срабатывают в отдельной, второй сессии — так сработавший будильник никогда не перебьёт ваш разговор с ботом.++---++## Словарь терминов++Если какие-то слова незнакомы — вот короткий словарь:++| Термин | Что это значит |+|--------|----------------|+| **VPS** | Удалённый мини-компьютер в интернете. Как ваш ПК, но работает 24/7 и находится в дата-центре |+| **SSH** | Способ подключиться к VPS через чёрное окно с текстом (терминал). Как удалённый рабочий стол, но текстом |+| **Token** | Секретный код для сервиса. Длинная строка букв и цифр, которую нельзя никому показывать |+| **Repo** | Репозиторий — папка проекта на GitHub. Там хранятся все файлы и история изменений |+| **.env** | Файл с секретами и настройками. Лежит только на сервере, никуда не публикуется |+| **Fork** | Ваша личная копия проекта. Можете менять как хотите, оригинал не затронете |+| **Clone** | Скачать проект на компьютер. После этого можете открыть его в VS Code |+| **tmux** | Программа, которая держит окно с запущенным Claude Code открытым, даже когда вы отключились от сервера. Благодаря ей сессия агента живёт круглосуточно |+| **systemd** | Встроенный в Linux «менеджер автозапуска». Следит, чтобы бот стартовал при включении сервера и перезапускался при сбоях |++---++## Что понадобится++| Компонент | Зачем | Стоимость |+|-----------|-------|-----------|+| **Claude Pro/Max** | AI-агент, который обрабатывает ваши записи | $20/мес |+| **VPS-сервер** | Чтобы бот работал круглосуточно | ~$5/мес |+| **GitHub** | Хранение и синхронизация всех ваших записей | бесплатно |+| **Deepgram** | Превращение голосовых сообщений в текст | бесплатно ($200 на старт) |++**Итого: ~$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. Откройте в браузере ссылку на оригинальный проект: [github.com/smixs/agent-second-brain](https://github.com/smixs/agent-second-brain)+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`++> ⚠️ **ВАЖНО: Сделайте репозиторий приватным!**+>+> Ваш форк сейчас **публичный** — все ваши цели и записи будут видны всему интернету!+>+> **Как закрыть:**+> 1. Откройте ваш репозиторий на GitHub+> 2. **Settings** → прокрутите вниз до **Danger Zone**+> 3. Нажмите **Change visibility** → выберите **Private**+>+> Или создайте новый приватный репозиторий и скопируйте туда файлы.++> **Где посмотреть свой логин:**+> Нажмите на свой аватар в правом верхнем углу GitHub — там будет написано ваше имя пользователя.++---++### 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-YYYY.md` — цели на год (переименуйте под текущий год, например `1-yearly-2026.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-YYYY.md`:**+```+Это шаблон годовых целей. На основе моего 3-летнего видения+помоги поставить цели на этот год. Задавай вопросы по одному.+```++**Для `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` | Категории записей, имена клиентов/проектов |+| `business-context.md` | Контекст вашей работы: компания, рынок, роли |+| `contacts.md` | Люди, которых агент должен узнавать в записях |++В той же папке лежат `goals.md`, `links.md`, `rules.md` и `report-template.md` — загляните и в них, там тоже есть подсказки, что заменить.++<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: Получите ключи ⏱ 10 мин++**Что нужно собрать:**+Вам понадобятся всего **два секретных кода (токена) и одно число**. Соберите их заранее и сохраните в надёжное место — блокнот, заметки или менеджер паролей. Скрипт установки спросит их у вас на сервере.++| Что | Откуда взять | Как выглядит |+|-----|--------------|--------------|+| Telegram Bot Token | @BotFather в Telegram | `7123456789:AAH...` |+| Ваш Telegram ID | @userinfobot в Telegram | `123456789` |+| Deepgram API Key | console.deepgram.com | Длинная строка |++Это всё. Больше никаких ключей и сервисов — напоминания и задачи агент делает сам, без внешних таск-менеджеров.++---++### 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 завершена++| Что проверить | Ожидаемый результат |+|---------------|---------------------|+| Telegram Bot Token | Строка вида `7123456789:AAH...` |+| Ваш Telegram ID | Число вида `123456789` |+| Deepgram API Key | Длинная строка букв и цифр |++> **Сохраните все токены** в надёжное место. Они понадобятся при настройке сервера.++Заодно решите, какая у вас **таймзона** (например, `Europe/Moscow`, `Asia/Tashkent`, `Europe/Minsk`) — скрипт установки спросит и её. По этой таймзоне агент будет присылать вечерний отчёт и срабатывать напоминания.++---++# Часть 3: Настройка сервера ⏱ 30–50 мин++Хорошая новость: в версии 3.0 вам **не нужно вручную устанавливать** Python, Node.js и остальное. Всё это делает один скрипт. От вас — купить сервер, создать пользователя и запустить одну команду.++### 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 небезопасно — и скрипт установки от 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 (замените `ВАШ_ЛОГИН` на ваш логин GitHub):++```bash+curl -fsSL https://raw.githubusercontent.com/ВАШ_ЛОГИН/agent-second-brain/main/bootstrap.sh | bash+```++Дальше скрипт ведёт вас за руку. Под капотом работает цепочка из трёх скриптов — знать это не обязательно, но полезно понимать, что происходит на экране:++1. **bootstrap.sh** — та самая команда выше. Скачивает установщик и запускает его.+2. **setup.sh** — интерактивный опросник. Он:+ - установит всё необходимое сам: git, tmux, uv, Node.js, Claude Code+ - спросит ваш **логин GitHub** и скачает ваш форк в `~/projects/agent-second-brain`+ - спросит **токены** по одному: Telegram Bot Token, ваш Telegram ID, Deepgram API Key (и сразу проверит, что формат правильный)+ - спросит вашу **таймзону** (например, `Europe/Moscow`; если просто нажать Enter — будет UTC)+ - предложит настроить **доступ к GitHub** для автосинхронизации записей (понадобится Personal Access Token — скрипт подскажет, где его взять)+ - попросит **авторизовать Claude Code** — про это следующий шаг, он важный+3. **upgrade.sh** — финальный аккорд, запускается автоматически. Ставит Python-зависимости, команду `dbrain`, сервисы автозапуска (systemd), запускает бота и проводит первый health check — самопроверку, что всё живо.++Отвечайте на вопросы скрипта и не пугайтесь бегущих строк — это нормально.++> **Если команда не сработала**, выполните то же самое вручную:+>+> ```bash+> cd ~+> git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git+> cd agent-second-brain+> bash setup.sh+> ```++---++### 3.4 Авторизуйте Claude Code++В какой-то момент скрипт остановится и скажет: **Claude Code is not logged in** — нужно войти в ваш аккаунт Claude (тот самый, где подписка Pro или Max). Без этого мозг агента не запустится.++Скрипт попросит сделать вход в **отдельном терминале**. Вот как:++1. **Не закрывая** окно с установкой, откройте **второе окно терминала** (на Mac: `Cmd+N` в Терминале; на Windows: запустите `cmd` ещё раз)+2. Во втором окне подключитесь к серверу под вашим пользователем:+ ```bash+ ssh myuser@ВАШ_IP_АДРЕС+ ```+3. Запустите Claude:+ ```bash+ claude+ ```+4. Claude предложит войти и покажет **ссылку**. Скопируйте её и откройте в браузере на вашем компьютере+5. Войдите в аккаунт Anthropic (выбирайте вход через подписку Claude Pro/Max, не API) и подтвердите доступ+6. Вернитесь во второе окно терминала — Claude подтвердит вход. Выйдите из него (наберите `/exit` или нажмите `Ctrl+C` дважды)+7. Вернитесь в **первое** окно с установкой и нажмите Enter — скрипт проверит вход и продолжит сам++После этого установка дойдёт до конца и покажет рамку **SETUP COMPLETE!** — значит, бот уже запущен.++---++### Контрольная точка: Часть 3 завершена++| Что проверить | Как проверить |+|---------------|---------------|+| Установка завершилась | На экране рамка `SETUP COMPLETE!` |+| Бот отвечает на /start | В Telegram найдите вашего бота, отправьте `/start` — видны кнопки меню |+| Голосовые распознаются | Отправьте голосовое — бот ответит по делу |+| Всё живо | На сервере выполните `dbrain status` — бот и сторож активны, «мозг: жив» |+| Работает после перезагрузки | Перезагрузите сервер (`sudo reboot`), подождите пару минут — бот снова отвечает |++Попробуйте сразу: напишите боту **«напомни через 10 минут размяться»** — и проверьте, что через 10 минут он напишет вам сам. Это лучший тест, что всё работает.++---++# Часть 4: Использование++### Кнопки бота++```+┌──────────────────────────────────────────┐+│ [📊 Статус] [⚙️ Обработать] [❓ Помощь] │+└──────────────────────────────────────────┘+```++| Кнопка | Что делает |+|--------|------------|+| 📊 Статус | Показывает сколько записей сегодня |+| ⚙️ Обработать | Запускает обработку всех записей прямо сейчас |+| ❓ Помощь | Показывает справку |++А где кнопка «Запрос»? Она больше не нужна: **любое** ваше сообщение — это и есть запрос. Просто пишите или наговаривайте боту, что хотите.++---++### Что можно отправлять++**Голосовые** — основной способ:+- «Надо написать Пете по проекту»+- «Идея: сделать лендинг с калькулятором»++**Текст** — ссылки, цитаты, быстрые мысли, вопросы агенту++**Фото и картинки** — скриншоты, фото досок: агент сохранит файл и сам прочитает, что на нём++**Файлы, видео, кружочки** — всё сохраняется в хранилище++**Пересланные посты** — из других чатов и каналов (агент запомнит и откуда)++**Альбомы** — несколько фото одним сообщением, агент обработает их вместе++---++### Напоминания и расписания — главная суперсила++Агент сам управляет своим расписанием. Никаких внешних приложений — говорите обычным языком:++- «Напомни через час про звонок» → напишет вам через час+- «Напомни завтра в 15:00 про презентацию» → разовое напоминание+- «Каждое утро в 9 — сводка дня» → повторяющееся расписание+- «Каждый будний день в 18:30 проверяй мою папку входящих» → регулярная проверка (и молчит, если нового ничего нет)+- «Покажи мои напоминания» / «Удали напоминание про зарядку» → управление списком++Напоминания срабатывают в отдельной сессии, поэтому будильник никогда не перебьёт ваш разговор с ботом.++---++### Разговор с контекстом++Сессия агента постоянная — он помнит, о чём вы только что говорили:++> **Вы:** что я писал про маркетинговый проект на той неделе?+>+> **Бот:** *находит и показывает записи*+>+> **Вы:** вторую идею оформи как заметку проекта с следующими шагами+>+> **Бот:** *создаёт заметку, связывает с другими*+>+> **Вы:** добавь туда ещё пункт про презентацию+>+> **Бот:** *обновляет ту же заметку*++Полезные команды в чате:++| Команда | Что делает |+|---------|------------|+| `/status` | Статус системы |+| `/process` | Запустить обработку записей |+| `/new` | Начать разговор с чистого листа (записи в файлах не трогает) |+| `/compact` | Сжать контекст разговора, если он стал слишком длинным |+| `/help` | Справка |++---++### Что происходит само, без вас++- **Каждый вечер в 21:00** (по вашей таймзоне) агент обрабатывает все записи за день: классифицирует, раскладывает по папкам, обновляет карточки — и присылает **отчёт в Telegram**: что произошло, что сделано, что висит.+- **Каждое утро в 08:00** проходит самопроверка (доктор): агент убеждается, что все системы живы, и чинит себя, если нужно.+- **Память забывает, как настоящая.** За память отвечает движок **autograph** — он использует кривую забывания Эббингауза: информация со временем «остывает», если вы к ней не возвращаетесь. Пять уровней — от «всегда в контексте» (текущие проекты, цели) до «почти забыто» (старый архив, который иногда случайно всплывает и даёт неожиданные идеи). Тот же движок следит за здоровьем хранилища: оценивает его по 100-балльной шкале, чинит сломанные ссылки, находит заметки-сироты и строит карты содержания (MOC). Движок живёт в отдельном репозитории — [github.com/smixs/autograph](https://github.com/smixs/autograph) — и работает на любом Obsidian-хранилище.++Вы не занимаетесь обслуживанием. Этим занимается агент.++---++# Часть 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**++Теперь вы видите все свои заметки, цели и мысли в красивом интерфейсе. Чтобы подтянуть свежие записи с сервера — откройте папку проекта в VS Code и нажмите **Sync Changes** (или выполните `git pull`).++**На iPhone/iPad:**+1. На компьютере переместите папку `vault` в iCloud Drive+2. На iPhone скачайте Obsidian из App Store+3. В приложении «Файлы» найдите папку `vault` в iCloud+4. В Obsidian нажмите «Open folder as vault» → выберите эту папку++**На Android:**+1. Установите [GitJournal](https://play.google.com/store/apps/details?id=io.gitjournal.gitjournal)+2. Подключите ваш GitHub репозиторий+3. Все заметки будут синхронизироваться автоматически++---++### Способ 2: GitHub напрямую++Все файлы хранятся в вашем репозитории на GitHub по адресу:+```+https://github.com/ВАШ_ЛОГИН/agent-second-brain+```++Вы можете:+- Просматривать заметки прямо на сайте+- Редактировать файлы через веб-интерфейс+- Скачивать обновления командой `git pull`++---++### Способ 3: Просто спросите бота++Самый простой способ — спросить напрямую в Telegram:+- «Что я записал вчера?»+- «Покажи мои цели на неделю»+- «Какие напоминания у меня стоят?»+- «Найди заметку про [тема]»++Бот найдёт и покажет всё что нужно прямо в Telegram.++---++# Обновление с прошлых версий++Уже пользуетесь Agent Second Brain первой или второй версии? Переход на v3.0 — это **одна команда**.++Подключитесь к серверу и выполните:++```bash+cd ~/projects/agent-second-brain+git pull+bash upgrade.sh+```++> Если у вас проект лежит в другой папке (например, прямо в `~/agent-second-brain`) — перейдите в неё: `cd ~/agent-second-brain`.++Скрипт сам:+- установит tmux и обновит зависимости+- подтянет свежий код+- **мигрирует старые сервисы** со старых имён `d-brain-*` на новые `dbrain-*` (старые отключит и удалит)+- установит команду `dbrain`+- запустит постоянную сессию и проведёт health check++Скрипт **идемпотентный** — это значит, что его безопасно запускать сколько угодно раз. Что-то пошло не так? Просто запустите `bash upgrade.sh` ещё раз.++> **Из .env можно удалить устаревшие строки** от старых версий (например, ключи внешних таск-менеджеров) — v3.0 их игнорирует. А встроенный навык `migrate-doctor` умеет диагностировать и чинить поломанные обновления: запустите на сервере `claude` и напишите «проверь моё обновление».++---++# Помощь++### Команда `dbrain` — ваш пульт управления++После установки на сервере доступна команда `dbrain` — простая обёртка над всеми проверками:++```bash+dbrain status # всё ли живо: бот, сторож, мозг+dbrain logs # последние логи бота+dbrain restart # перезапустить сервисы (мозг при этом выживает)+dbrain doctor # полный осмотр с диагнозом+dbrain attach # подключиться к живой сессии мозга и посмотреть, что он делает+dbrain clear # очистить память текущего разговора (файлы не трогает)+dbrain login # войти в Claude заново, если слетела авторизация+```++> **`dbrain attach` — это окно в голову агента.** Вы увидите ту самую живую сессию Claude Code, в которую бот печатает ваши сообщения. Посмотрели — выходите комбинацией `Ctrl+B`, затем `D` (именно отпустив Ctrl+B перед D). **Не закрывайте окно крестиком и не жмите Ctrl+C** — сессия должна остаться жить.++---++### Если что-то пошло не так++Самый простой способ решить проблему — запустить программу `claude` прямо в чёрном окне сервера.++1. Подключитесь к серверу (как в Части 3)+2. Перейдите в папку проекта:+ ```bash+ cd ~/projects/agent-second-brain+ ```+3. Запустите Claude:+ ```bash+ claude+ ```+4. Напишите ему:+ ```+ Я настраиваю бота, у меня возникла ошибка: [опишите что случилось]+ Что мне сделать?+ ```++Claude прочитает файлы проекта и поможет решить проблему.++---++### Частые проблемы++**Бот не отвечает в Telegram:**+Проверьте, работает ли он. Подключитесь к серверу и выполните:+```bash+dbrain status+```+Бот и сторож должны быть `active`, мозг — «жив». Если нет:+```bash+dbrain repair+```++**Голосовые не распознаются:**+Проверьте, правильно ли вы ввели ключ Deepgram при настройке:+```bash+cat ~/projects/agent-second-brain/.env | grep DEEPGRAM+```+Поправить можно прямо в файле: `nano ~/projects/agent-second-brain/.env`, затем `dbrain restart`.++**Claude не работает / агент молчит:**+Скорее всего, слетела авторизация. Войдите заново:+```bash+dbrain login+```+Откройте ссылку на телефоне или ноутбуке, подтвердите и вставьте код обратно в терминал.++**Хочется посмотреть логи:**+```bash+dbrain logs+# или в реальном времени:+journalctl --user -u dbrain-bot -f+```++---++<details>+<summary><strong>Технические детали (для продвинутых)</strong></summary>++### Архитектура v3.0++```+Telegram → Deepgram → постоянная сессия Claude Code (tmux) → Obsidian vault → отчёт в Telegram+```++Бот не запускает новый процесс Claude на каждое сообщение. Он держит одну долгоживущую **интерактивную** сессию Claude Code в tmux-окне и программно печатает в неё промпты. Это интерактивное использование — оно остаётся на вашей подписке Claude Pro/Max, без пооперационной оплаты. Сторож (watchdog) и ежедневный доктор следят за здоровьем сессии и перезапускают её при сбоях. Запланированные задания (напоминания) выполняются во второй, изолированной сессии.++### Сервисы++Всё работает на **пользовательских** systemd-юнитах (`systemctl --user`, без root):++| Юнит | Что делает |+|------|-----------|+| `dbrain-bot.service` | Telegram-бот + постоянная сессия мозга |+| `dbrain-watchdog.service` | Сторож: следит за здоровьем и чинит |+| `dbrain-process.timer` | Ежедневная обработка записей в 21:00 |+| `dbrain-doctor.timer` | Ежедневная самопроверка в 08:00 |++Чтобы сервисы работали без вашего входа на сервер и стартовали при перезагрузке, скрипт установки включает linger (`loginctl enable-linger`).++### Полезные команды++```bash+# Статус всего+dbrain status+systemctl --user status 'dbrain-*'++# Логи бота+journalctl --user -u dbrain-bot -f # в реальном времени+journalctl --user -u dbrain-bot -n 100 # последние 100 строк++# Перезапустить бота (сессия мозга выживает — KillMode=process)+systemctl --user restart dbrain-bot++# Остановить / запустить+systemctl --user stop dbrain-bot+systemctl --user start dbrain-bot++# Таймеры+systemctl --user list-timers++# Запустить обработку вручную+cd ~/projects/agent-second-brain+./scripts/process.sh++# Обновить код и сервисы (идемпотентно)+cd ~/projects/agent-second-brain+bash upgrade.sh+```++### Файл .env++Все настройки в `~/projects/agent-second-brain/.env` (создаётся скриптом установки, права 600):++```bash+TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx+DEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx+VAULT_PATH=./vault+ALLOWED_USER_IDS=[123456789]+TZ=Europe/Moscow+```++> В `ALLOWED_USER_IDS` обязательно сохраняйте квадратные скобки! Первый ID в списке получает отчёты и оповещения о здоровье системы.++Опционально: `CLAUDE_MODEL=sonnet` — переключить сессию на Sonnet, если упираетесь в недельные лимиты подписки; `CRON_ENABLED=false` — выключить планировщик напоминаний.++### 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-сервер | Что можно делать |+|--------|------------|------------------|+| **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) | Страницы, базы данных |+| **GitHub** | [github-mcp-server](https://github.com/github/github-mcp-server) | Issues, PR, репозитории |++Полный список: [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers)++### Навыки агента++| Навык | Что делает |+|-------|-----------|+| **dbrain-processor** | Классифицирует записи, раскладывает заметки |+| **autograph** | Память и здоровье хранилища: забывание по Эббингаузу, граф связей, MOC ([отдельный репозиторий](https://github.com/smixs/autograph)) |+| **cron** | Агент сам управляет своим расписанием: напоминания, интервалы, cron-выражения — из обычного языка |+| **migrate-doctor** | Диагностирует и чинит поломанные обновления со старых версий |++### Если сервисы не установились++Не редактируйте юниты руками — все сервисы ставит и чинит один идемпотентный скрипт:++```bash+cd ~/projects/agent-second-brain+bash upgrade.sh+```++Он переустановит юниты `dbrain-*`, перезапустит сервисы и проведёт health check. Безопасно запускать повторно.++</details>++---++<details>+<summary><strong>Инструкция для Claude Code (читает Claude, не вы)</strong></summary>++### Команды с sudo++Claude Code не может выполнять команды с `sudo` — они требуют ввода пароля.++Когда нужно выполнить команду с sudo, попроси пользователя:++```+Мне нужно выполнить команду с sudo, но я не могу ввести пароль.++Пожалуйста, сделайте следующее:++1. Откройте новую вкладку терминала (Ctrl+Shift+T или Cmd+T)+2. Подключитесь к серверу:+ ssh ВАШ_ПОЛЬЗОВАТЕЛЬ@ВАШ_IP_АДРЕС++3. Выполните эту команду:+ sudo [КОМАНДА]++4. Введите пароль когда попросят+5. Вернитесь ко мне и скажите что готово+```++### Ручные шаги настройки++**Клонирование репозитория:**+```bash+cd ~+mkdir -p projects+cd projects+git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git+cd agent-second-brain+uv sync+```++**Создание .env:**+```bash+nano .env+```++Содержимое:+```bash+TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx+DEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx+VAULT_PATH=./vault+ALLOWED_USER_IDS=[123456789]+TZ=UTC+```++> В `ALLOWED_USER_IDS` обязательно сохраняйте квадратные скобки!++**Тестовый запуск:**+```bash+uv run python -m d_brain+```++**Установка сервисов и постоянной сессии:**+```bash+bash upgrade.sh+```++НЕ создавай systemd-юниты вручную и НЕ используй системные (root) юниты — все сервисы ставятся как `systemctl --user` юниты скриптом `upgrade.sh`. НЕ запускай Claude в headless-режиме для обработки сообщений — обработка идёт через постоянную интерактивную сессию в tmux, это инвариант архитектуры v3.0 (проверяется скриптом `scripts/check-no-claude-p.sh`).++**Настройка 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 → Fine-grained tokens → токен только на репозиторий agent-second-brain с правом Contents: Read and write++```bash+chmod 600 .git/config+git remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/agent-second-brain.git+```++</details>