busabase/busabase

Open-source database & workspace for AI agents — structured data, durable knowledge, reusable skills, runnable apps, and human review on the writes that matter. Local-first and self-hostable.

Busabase – AI 에이전트를 위한 공유, 버전 관리 워크스페이스

정의 – Busabase는 오픈소스 데이터베이스 + UI로, 대규모 언어 모델 에이전트(Claude Code, Codex, Cursor, Gemini 등)와 인간이 동일한 구조화된 레코드, 문서, 스킬, 작은 앱을 읽고 쓸 수 있게 합니다. 에이전트가 만드는 모든 변경은 diff, 작성자, 기록이 포함된 변경 요청으로 저장되므로 작업이 지속적이고 감사 가능하며 병합 전에 검토할 수 있습니다.

중요성 – 오늘날 대부분의 LLM 기반 도구는 출력을 임시 채팅이나 개인 메모에 저장합니다. 도구를 전환하면 컨텍스트가 손실되고 프로젝트를 다시 설명해야 합니다. Busabase는 에이전트에게 영구적인 "기록 시스템"을 제공하여 동일한 지식 기반에서 시작하고 업데이트를 제안하며 수락 여부를 사용자(또는 정책)가 결정할 수 있게 합니다.

빠른 시작 (5분)

# 로컬 서버 실행 (내장 PGlite + 파일 스토리지)
npx busabase server

http://localhost:15419/dashboard/local을 엽니다. DB, 계정, 구성이 필요 없습니다.

LLM 에이전트에 Agent Skill 파일의 URL을 제공하여 서버를 가리키게 합니다. 예:

http://localhost:15419/SETUP_SKILL.md

에이전트는 지침을 따르고, 워크스페이스를 읽고, 출력을 변경 요청으로 다시 씁니다.

Busabase는 Docker로 실행하거나 CLI(npm i -g busabase)를 설치하거나 데스크톱 앱(macOS/Windows/Linux)을 다운로드하여 오프라인, 로컬 우선 경험을 얻을 수도 있습니다.

핵심 기능 (README에 설명됨)

통합 워크스페이스 – 타입화된 레코드(Bases), 문서, 파일, 스킬, AirApps, 화이트보드, 워크플로우가 모두 단일 트리의 일급 노드입니다.
공유 스킬 – SKILL.md 플레이북과 사용자 지정 프롬프트가 워크스페이스에 있으며, 연결된 에이전트는 행동하기 전에 참조할 수 있습니다.
변경 요청 – 모든 쓰기는 작성자, 메시지, 타임스탬프가 포함된 diff입니다. 권한에 따라 자동 병합되거나 검토를 기다립니다.
데이터 기반 라이브 앱 – 작은 "AirApps"가 Busabase 내에서 실행되어 워크스페이스 데이터를 읽고 대시보드, CRM, 콘텐츠 데스크 등을 제공합니다.
에이전트 비종속 – 내장 모델이 없습니다. Agent Skill, MCP, OpenAPI 또는 간단한 CLI를 통해 Claude Code, Codex, Cursor, Gemini CLI, n8n 또는 모든 사용자 지정 프로세스를 연결합니다.
템플릿 – 전체 워크스페이스(스키마, 샘플 데이터, 앱, 에이전트 매뉴얼)를 원클릭 설치.
로컬 우선 및 오픈소스 – MIT 라이선스, 내장 PGlite 데이터베이스 또는 외부 Postgres/S3에서 실행, 오프라인 작동, 호스팅 SaaS 버전(Busabase Cloud) 지원.

일반적인 사용 사례

도메인	에이전트가 하는 일	Busabase에 남는 것
소프트웨어 전달	피드백을 작업으로 전환, 코드 작성/테스트, 릴리스	피드백, 작업, 사양, 규칙, 릴리스 노트
SEO 및 콘텐츠	트렌드 추적, 기사 초안, 게시	키워드 연구, 브리프, 초안, 게시된 페이지
CRM	잠재 고객 조사, 방문 기록, 후속 조치	회사, 연락처, 메모, 후속 기록
팀 메모리	결정, 출처, 컨텍스트 캡처	미래 에이전트를 위한 검색 가능한 지식 베이스
데이터셋	예제 레이블링, 증거 첨부, 품질 점수	큐레이션되고 검토된 훈련/평가 데이터

템플릿에서 시작하세요. 예: 준비된 CRM 워크스페이스:

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

아키텍처 개요

프론트엔드 – apps/busabase – 로컬(데스크톱) 또는 클라우드에서 실행되는 Next.js UI.
엔진 – packages/busabase-core – 노드, 관계, 파일 트리, 검토 기본 요소, 검색, 에이전트 통합, 공개 API 구현.
API 표면 – MCP, OpenAPI, busabase-cli 클라이언트를 통해 노출.
스토리지 – 기본 내장 PGlite(SQLite 스타일 Postgres) 및 파일 스토리지; 외부 Postgres 및 S3 호환 객체 스토리지로 교체 가능.
보안 모델 – 범위가 지정된 자격 증명(changeRequest 수준, autoMerge 플래그 등) 및 검토 받은 편지함; 오픈소스 서버는 신뢰할 수 있는 로컬 또는 사설 네트워크 사용을 위한 것입니다.

참여하기

로컬 실행 – pnpm install && pnpm --filter busabase dev
기여 – GitHub 저장소를 통해 lint, 타입 체크, PR 제출.
커뮤니티 – 웹사이트, 문서, 포럼, YouTube 채널, X, LinkedIn.

라이선스

MIT – 개인, 상업, 클라우드 사용에 무료.

요약 – Busabase는 인간과 LLM 에이전트가 모두 읽고 쓸 수 있는 지속적이고 쿼리 가능하며 감사 가능한 워크스페이스를 제공합니다. 에이전트 출력을 일시적인 채팅 로그가 아닌 구조화되고 버전 관리된 데이터로 유지하여 다중 에이전트 워크플로우, 핸드오프, 장기 지식 보존을 실용적으로 만듭니다.