Busabase — открытая база данных и рабочее пространство для ИИ-агентов

Busabase — открытая база данных и рабочее пространство для ИИ-агентов. Проект написан на TypeScript и распространяется по лицензии MIT. Идея простая: агенты не должны начинать каждую сессию с чистого листа. Они читают из одной общей базы записи, документы, скиллы и приложения, которые оставили люди и другие агенты. А важные изменения агента человек проверяет перед публикацией.

Проблема, которую решает проект

Каждая сессия агента начинается с нуля. CLAUDE.md лежит в одном репозитории. Лучшие результаты работы агента остаются в чате и пропадают. При смене инструмента проект приходится объяснять заново.

Busabase переворачивает эту схему. Агент подключается к рабочему пространству и находит там готовый контекст. Свою работу он записывает обратно — с диффом и историей изменений. Сами агенты остаются без внутреннего состояния, а работа сохраняется в базе.

Что внутри рабочего пространства

Все виды контента — узлы одного дерева. Полный список описан в документации типов узлов.

Отдельный раздел — Playbooks. Это каталог скиллов и кастомных промптов. Подключённый агент может заглянуть в него перед действием.

Приложение можно не писать, а попросить агента: превратить базу в дашборд, CRM или панель для работы с контентом. Готовое приложение получит свой SKILL.md — его прочитает следующий агент.

Каждое изменение — под контролем

Запись агента оформляется как запрос на изменение (Change Request). Внутри — сообщение, дифф по полям, автор и история. Права доступа решают, применить изменение сразу или оставить его на проверку в Inbox.

Ограничения работают на трёх уровнях:

• Учётные данные с уровнем changeRequest могут только предлагать изменения.
• Один вызов может отключить автослияние флагом autoMerge: false.
• Установка шаблона с флагом --require-review задерживает его контент до одобрения.

Любое изменение остаётся видимым, привязанным к автору и обратимым. Есть и мобильное приложение — с него можно проверять запросы на изменение и открывать записи.

Как подключить агента

Работает с Claude Code, Codex, Cursor, Gemini CLI, OpenCode, OpenClaw, Hermes, Buda AI, n8n — или с вашим собственным процессом.

Гайды для конкретных агентов: Claude Code и раздел подключения своего агента.

Быстрый старт

npx -y busabase@latest server

Откройте http://localhost:15419/dashboard/local. Настраивать ничего не нужно: база данных, аккаунт и конфиг не требуются. Внутри уже запущены встроенная база PGlite, локальное файловое хранилище и демо-рабочее пространство.

Затем вставьте агенту такой текст:

Read and follow the Busabase Agent Skill — it is the single source of truth:
http://localhost:15419/SETUP_SKILL.md

Follow its onboarding to connect to this workspace. Don't choose a merge policy yourself unless I ask for one — submit the change and let Busabase apply my permissions to decide whether it merges now or waits for review. Reply to me in English.

Проверьте так: пусть один агент запишет обновления и договорённости по проекту. Откройте другого агента и спросите: «Что изменилось в проекте на этой неделе?» Ответ придёт из рабочего пространства, а не из вашего буфера обмена.

Другие способы запуска:

# Docker (Docker Hub: busabase/busabase)
docker run --rm -p 15419:15419 -v ~/.busabase/data:/data busabase/busabase

# Глобальная установка
npm i -g busabase       # затем: busabase server

Есть и десктопная версия для macOS, Windows и Linux — busabase.com/download. Она работает локально и офлайн. Локальные данные лежат в ~/.busabase/data/. Переменные окружения BUSABASE_DATA_DIR, PG_DATABASE_URL и STORAGE_URL позволяют вынести данные в другое место, подключить внешний Postgres или S3-совместимое хранилище.

Сценарии использования

Рабочее пространство можно установить целиком из шаблона — вместе с данными, приложениями и инструкцией для агента:

busabase-cli install https://github.com/busabase/templates/tree/main/templates/busa-crm

Больше шаблонов — на busabase.com/templates, больше сценариев — в документации по сценариям.

Чем отличается от знакомых инструментов

Busabase сам работает на Postgres или встроенном PGlite. Это надстройка-рабочее пространство, а не замена базе данных вашего приложения.

Редакции и устройство

Открытая версия бесплатна, работает без логина и офлайн. Busabase Cloud — хостинг-версия с несколькими пользователями, ролями и правами. Cloud Connect связывает локальное рабочее пространство с облаком через защищённый туннель: данные остаются на вашей машине, а локальные агенты продолжают работать.

Внутри два главных блока. apps/busabase — локальная оболочка на Next.js для одного рабочего пространства. packages/busabase-core — сам движок: узлы, записи, файловые деревья, примитивы проверки, поиск, агенты и контракты API. Наружу движок отдаётся через MCP, OpenAPI и busabase-cli.

Про безопасность: открытый сервер рассчитан на доверенную локальную машину или приватную сеть. Не открывайте эндпоинты записи в публичный интернет без аутентификации и обратного прокси. Для удалённого доступа используйте ограниченные учётные данные или Cloud Connect.

Проект развивается на GitHub: баг-репорты и идеи принимают в Issues и Discussions.