에이전트와 에이전트를 만드는 사람들을 위해
에이전트는 세션이 바뀌면 맥락을 잃어요. 메모를 남길 곳도, 자신만의 ID도, 장기 기억도 없죠. blackbear는 그 모두를 제공해요. 암호화되고, 로컬 우선이며, 누가 썼는지 기록되고, bb 명령줄이나 에이전트가 이미 쓸 줄 아는 MCP 서버로 접근할 수 있어요. 한 번 설치하면 에이전트에게 든든한 공간이 생겨요.
{
"id": "3831d16e8aca74ea6026c",
"title": "Session Context",
"format": "markdown",
"createdAt": "2026-06-09T14:32:00Z"
} 에이전트 세션은 매번 0부터 시작해요. 컨텍스트 창은 만료되고, 대화 기록은 잘려 나가고, 중요한 것을 담아 둘 프라이빗하고 영구적인 공간도 없어요. 에이전트는 30분 동안만 똑똑하고, 그 뒤에는 모든 걸 잊어버려요.
메모, 결정, 사용자 취향, 프로젝트 맥락을 로컬에 암호화해 저장하고 검색할 수 있어요. bb file search로 모두 되살려요. 세션, 재시작, 모델 변경을 넘어서도 에이전트는 멈춘 곳에서 이어서 시작해요.
에이전트는 여기서 손님이 아니에요. bb profile create로 작성자 검증을 위한 서명 키를 가진 정식 프로필을 만들 수 있어요. 에이전트가 쓰는 모든 노트, 할 일, 일정에는 그 이름이 남아요.
모든 명령이 기계가 읽을 수 있는 출력을 위한 --json을 지원해요. 종료 코드는 예측 가능하고, ID는 고유한 접두사로도 지정할 수 있어요. HTML 파싱도 스크래핑도 필요 없이, 깔끔한 데이터만 돌아와요.
앱과 같은 XChaCha20-Poly1305 암호화. 보관함 키는 컴퓨터를 떠나지 않아요. 클라우드는 암호문만 봐요. 에이전트의 생각은 저희로부터도 지켜져요.
저장 시 암호화되는 로컬 SQLite 데이터베이스로, 클라우드에 의존하지 않아요. 오프라인에서도, 망이 분리된 환경에서도, CI 러너에서도 작동해요. 동기화는 명시적이에요. 원할 때 bb sync를 실행하세요.
노트, 할 일, 캘린더, 시트, 문서, 슬라이드, 파일 등 blackbear의 모든 것. 에이전트가 쓴 내용은 어떤 기기의 앱에서든 그 프로필 이름으로 표시돼요. 같은 보관함, 같은 암호화, 같은 동기화.
brew install xavi-group/tap/bb 또는 바이너리를 다운로드하세요. macOS, Linux, Windows를 지원해요.
bb auth login을 실행하면 브라우저가 열리고, 이 컴퓨터의 API 키에 줄 범위를 고를 수 있어요. 그다음 bb vault unlock. 보관함 키는 OS 키체인(헤드리스 러너에서는 암호화된 파일)에 안전하게 저장되므로, 그 뒤로는 모든 명령이 바로 작동해요. 환경 변수도, 다시 입력할 일도 없어요.
bb profile create claude로 에이전트에게 전용 프로필과 서명 키가 생겨요. 모든 기록에 작성자가 남고, bb profile export-key로 서명된 git 커밋을 위한 SSH 형식 키를 건네줄 수 있어요.
한 줄이면 MCP 서버가 추가돼요: claude mcp add blackbear -- bb mcp(또는 codex mcp add, 혹은 모든 MCP 클라이언트). 함수 호출이나 하위 프로세스 등 어떤 도구 체계에서든 구조화된 JSON으로 bb를 호출할 수도 있어요. MCP 더 알아보기
어떤 기기에서 blackbear를 열어도 에이전트가 쓴 노트, 할 일, 일정이 각각 프로필 이름과 함께 있어요. 앱에서 수정하고 동기화하면 CLI에도 반영돼요. 사람과 에이전트가 하나의 워크스페이스를 함께 써요.
MCP 서버
bb mcp는 Pax의 도구를 내 컴퓨터에서 MCP로 제공해요. 에이전트는 Pax가 앱에서 쓰는 것과 같은 도구와 엔진으로 노트, 문서, 시트, 슬라이드, 캔버스, 페이지, 할 일, 캘린더를 검색하고, 읽고, (허용하면) 변경할 수 있어요. 호스팅되는 것은 아무것도 없어요.
파일, 할 일, 일정을 한 번에 검색하고, ID로 열고, 개요를 보고, 편집해요. 대상은 Markdown 노트, 문서, 시트, 슬라이드, 캔버스, 페이지, 그리고 할 일과 일정이에요. 결과는 읽기 쉽고 구조화된 형태로 돌아오고, 실패한 호출은 고정된 코드와 힌트로 이유를 알려 줘요.
bb mcp만 실행하면 읽기만 해요. --writes를 추가하면 만들기, 편집, 휴지통으로 옮기기가 가능하고, 삭제한 항목은 휴지통에서 복원할 수 있어요. Pax에게 읽기 전용으로 지정한 항목은 그대로 유지되고, 앱에서 승인이 필요한 작업은 여기서 거부돼요.
서버는 내 컴퓨터에서 stdio로 실행되고, 이미 있는 암호화된 워크스페이스 사본으로 작업해요. 시작할 때와 변경 직후에 동기화하고, --no-sync를 쓰면 완전히 오프라인으로 유지돼요.
또는 Blackbear 플러그인을 설치하세요. 같은 서버를 연결하고, 먼저 찾은 다음 ID로 작업하도록 에이전트에게 알려 주는 짧은 스킬을 더해요. Claude Code에서는 /plugin marketplace add xavi-group/blackbear-plugins 다음에 /plugin install blackbear@blackbear. Codex에서는 codex plugin marketplace add xavi-group/blackbear-plugins 다음에 /plugins에서 설치하세요. GitHub에서 보기 Pax의 대화는 앱 안에만 머물고 절대 노출되지 않아요.
API 키
컴퓨터와 에이전트마다 내가 고른 범위만 가진 계정 API 키를 따로 발급해요. bb auth login을 실행하면 브라우저가 열리고 거기서 목록을 확인해요. 각 키는 다른 키에 영향을 주지 않고 따로 취소할 수 있어요.
sync 동기화된 워크스페이스를 읽고 쓰며 보관함 잠금을 해제해요. 컴퓨터를 기기로 추가하는 유일한 범위예요.
account:read 계정, 기기, 키를 볼 수 있어요. 아무것도 바꾸지 않아요.
media 첨부 파일을 업로드하고 다운로드해요.
messaging 종단 간 암호화된 메시지를 보내고 받아요.
collab 실시간 공동 편집에 참여해요.
inference AI models로 표시됨 Blackbear가 관리하는 모델, 이미지 생성, 웹 검색. 크레딧을 사용하므로 미리 선택되지 않아요.
Settings › Account › API keys에 모든 키가 범위와 함께 표시돼요. 거기서 키를 발급하거나(보관함으로 확인하고, 키는 한 번만 표시돼요), 더 이상 쓰지 않는 키를 즉시 취소할 수 있어요.
bb auth login --api-key는 발급한 키를 $BLACKBEAR_API_KEY, 파이프 입력, 또는 숨겨진 프롬프트에서 읽어 로그인하므로 셸 기록에 남지 않아요. --no-browser를 쓰면 로그인 링크를 열지 않고 출력해요.
Web Clipper는 전용 키를 쓰요. 내 기기 중 하나에 봉인된 클립을 넣는 것만 할 수 있고, 다른 키는 그것을 할 수 없어요.
bb discover 구조화된 열린 웹. arXiv, Hacker News, GitHub 트렌딩, 모든 RSS 피드. 에이전트가 읽고 정리할 수 있는 깔끔한 Markdown으로 가져와요.
bb store 스토어: 키체인, 키-값, 데이터베이스. 문서와 노트를 넘어선, 에이전트를 위한 구조화된 상태.
bb file template 템플릿: 데일리 노트, 회의록, 저널. --template으로 템플릿에서 파일을 만들어요.
에이전트에게 필요한 모든 것. 모든 명령이 --json을 지원해요.
bb file md create "Title" -c "…" Markdown 노트 만들기. --stdin으로 내용을 파이프할 수도 있어요
bb file search "query" 보관함의 모든 파일을 전체 텍스트 검색
bb file cat <id> 종류에 상관없이 파일 내용을 표준 출력으로 출력
bb file list --type md 파일 목록. 종류, 태그, 폴더로 필터링
bb file update <id> --content "…" 내용 교체, 이동, 태그, 고정, 보관
bb task create "Title" --due tomorrow --priority, --tags, 상대 날짜로 할 일 만들기
bb task list --open 할 일 목록: --open, --done, --archived
bb event create "Standup" --at "9am" 평소 말로 일정 등록. ISO 8601도 가능
bb event list 기본은 앞으로 일주일. --from과 --to로 범위 지정
bb profile create claude 전용 서명 키를 가진 에이전트의 정식 ID
bb sync 풀과 푸시. 양방향 E2EE 동기화
bb status 인증, 보관함, 동기화, 프로필, 기기 상태를 한눈에
bb mcp Pax의 도구를 로컬 MCP 서버로. 읽기 전용
bb mcp --writes 만들기, 편집, 이동, 휴지통으로 옮기기도 가능
bb auth login --scopes sync,account:read 브라우저 로그인에서 제안할 범위를 미리 선택
bb auth login --api-key Settings에서 발급한 키로 헤드리스 로그인
ID는 고유한 접두사로도 지정할 수 있어요. 그 밖에도 태그, 폴더, 스토어, 템플릿, 내보내기 등이 있어요: bb help