Твій Telegram — звичайними файлами

Ось що лягає на диск — один файл на чат за місяць:

Частина 1 — Встановлення

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

brew install tggo/tap/tg-archive

tg-archive version

curl -LO https://github.com/tggo/tg-archive/releases/latest/download/tg-archive_0.2.0_linux_amd64.tar.gz
tar -xzf tg-archive_0.2.0_linux_amd64.tar.gz
sudo install tg-archive /usr/local/bin/

Частина 2 — Отримати ключі

Telegram видає ключі доступу на кожен акаунт окремо. Будь-якому клієнту потрібна своя пара, і твоя нікуди не передається — навіть авторам цієї програми. Це дві хвилини.

Частина 3 — Перший запуск

tg-archive setup

tg-archive login

tg-archive backfill

tg-archive backfill --limit 200

brew services start tggo/tap/tg-archive

tg-archive live

Що ти отримуєш

~/TelegramArchive/
├── index.md                      ← таблиця всіх чатів
└── chats/
    └── anna-smith-428424641/
        ├── 2017-05.md
        └── 2026-08.md            ← один файл на місяць

Наведи Obsidian на цю теку — і листування стає блокнотом з пошуком і зв'язками. Або користуйся Spotlight, grep, будь-яким редактором: це звичайні текстові файли.

Чому редагування й видалення відображаються чесно

Повідомлення спершу лягають у невелику базу, а Markdown малюється з неї. Тому коли співрозмовник редагує повідомлення — архів оновлює той самий рядок і ставить (edited); коли видаляє — архів лишає його і позначає (DELETED). Усі файли можна перебудувати будь-коли, навіть без інтернету:

tg-archive rerender

Частина 4 — Як знаходити

Пошук працює через повнотекстовий індекс: миттєвий навіть на сотнях тисяч повідомлень і не спотикається об великі літери в українській — на відміну від звичайного пошуку підрядка.

tg-archive search "адреса доставки"
tg-archive search "фундамент" --chat VABRAM --from 2026-01-01

Усі слова мають зустрітися. "у лапках" — точна фраза, слов* — за початком слова, а звузити можна через --chat, --sender, --from, --to.

Фото, голосові та файли

За замовчуванням зберігаються лише позначки. Щоб тримати й самі файли, постав "media": "small" (або "all") у конфізі й запусти:

tg-archive media

Вони лягають у attachments/, а в Markdown замість слова [photo] з'являється саме зображення — Obsidian показує його прямо в тексті.

Чи чогось не бракує?

tg-archive doctor          # чого бракує
tg-archive doctor --fix    # дотягнути

Другий акаунт

tg-archive --profile work setup
tg-archive --profile work backfill

Окремі налаштування, окремий вхід, окремий архів.

Частина 5 — Підключити до Клода

Та сама програма вміє працювати MCP-сервером — так Клод під'єднується до інструментів на твоїй машині. Одна команда:

claude mcp add tg-archive -- tg-archive mcp

Далі можна питати «що Анна писала про поїздку в червні?» або «знайди всі повідомлення, де мені надсилали адресу». Клод читає локальний архів, тому відповідає миттєво і працює навіть без мережі.

Якщо хочеш, щоб Клод ще й писав

claude mcp add tg-archive -- tg-archive mcp --allow-send

Claude Desktop замість Claude Code

У Claude Desktop немає команди claude mcp add — він читає власний файл конфігурації. Відкрий (або створи):

~/Library/Application Support/Claude/claude_desktop_config.json

і додай tg-archive у mcpServers:

{
  "mcpServers": {
    "tg-archive": {
      "command": "/opt/homebrew/bin/tg-archive",
      "args": ["mcp"]
    }
  }
}

Шпаргалка команд

Коли щось пішло не так

Чесні застереження