Первый запуск

bee хранит на вашей машине ровно одну вещь: как добраться до хранилища конфигурации. Всё остальное — ключи провайдеров, эндпоинты, правила, память — живёт в MongoDB и разделяется всеми машинами и всеми агентами, которые смотрят в то же хранилище.

1 · Подключите bee к хранилищу

bee init

Мастер спрашивает одну строку подключения к Mongo, проверяет её вживую и только потом записывает ~/.bee/config.json с правами 0600. Соединение, которое не отвечает, никогда не сохраняется.

Скриптуемый, неинтерактивный вариант:

bee init --mongo "mongodb://localhost:27017" --database bee --collection config

Подойдёт любая MongoDB

Чтобы попробовать, хватит локального контейнера:

docker run -d --name bee-mongo -p 27017:27017 mongo:8
bee init --mongo "mongodb://localhost:27017" --database bee --collection config

Член набора реплик объявляет себя под тем именем, которое знает — часто это имя контейнера, которое ваша машина не может разрешить. Драйвер пытается достучаться до этого имени и зависает на этапе обнаружения. Подключайтесь напрямую:

bee init --mongo "mongodb://localhost:27018/?directConnection=true" \
         --database bee --collection config

Отдельное хранилище

BEE_HOME заменяет для bee ваш домашний каталог, и bee всё равно добавляет к нему .bee. Указав каталог, вы получите <этот каталог>/.bee/config.json:

export BEE_HOME=/путь/к/проекту
bee init --mongo "mongodb://localhost:27017" --database bee_test --collection config
# → /путь/к/проекту/.bee/config.json

Удобно для одноразового тестового хранилища, которое не должно трогать то, где живёт настоящая работа.

2 · Дайте ему мозг (необязательно)

Нужно только для bee ask. Память, правила и lint работают и без этого.

bee config set ask.provider deepseek
bee config set deepseek.apiKey sk-... --secret
bee config show          # секреты замаскированы

Поддерживаются DeepSeek, OpenAI и Anthropic.

3 · Создайте первую запись

bee remember "Redis кэширует токены сессий, а не данные пользователей" \
  --type decision --reason "у пользовательских данных другой TTL"

bee remember search "redis"

4 · Подключите к своему агенту

bee hook install --harness claude --scope project

Что каждая среда поддерживает, а что нет — см. Хуки.

Что где лежит

что	где
Строка подключения к Mongo	`~/.bee/config.json` (`0600`) — единственный локальный файл
Модель эмбеддингов	`~/.bee/models/` — скачивается при первом семантическом поиске
Всё остальное	ваше хранилище конфигурации в MongoDB