brigade

🦁 Brigade — 엔터프라이즈급으로 구축된 당신만의 개인 인텔리전스

엔터프라이즈 규모를 위해 구축. 모두에게 열려 있음. · 앱이 아닌 생태계.

🔐 저글링할 토큰 없음. 드라마 없음. 비밀 정보 복사-붙여넣기 없음, 텔레메트리 없음 —
우리가 처리합니다, 당신이 아니라 . 당신의 API 키는 당신의 기기에 남아 있으며, 중간자에게 절대 전송되지 않습니다.

🔑 API 키가 없다고요? 문제없습니다. Claude , ChatGPT , 또는
Copilot 구독으로 로그인하세요 — 또는 이미 Claude Code나
Codex CLI에 로그인되어 있다면 그 로그인을 재사용하세요 (브라우저 없음, 재인증 없음).

🩸💥 B³ — Brigade Bloody Benchmark 💥🩸

v1.9.0의 NEW · 당신의 크루를 늑대들에게 던져버리는 단 하나의 명령 (애정을 담아)

세 개의 B. 하나의 피비린내 나는 명령. 당신의 크루 — 열린 인터넷 위로 풀려나다.

Brigade는 당신의 크루입니다. Bloody는 당신이 그것에 하는 일 — 그물 없이, 뜨거운 터널을 지나 야생으로 내던지는 것. Benchmark는 펀치라인입니다: 유일하게 중요했던 테스트는 실험실이 아니라, 새벽 3시에 낯선 이들이 당신의 에이전트를 찔러보는 것입니다. 그것을 견뎌내면, 당신은 출시한 것입니다.

내부적으로는 온순합니다 — 엣지에서 HTTPS, 계정 없음, 설정 없음. 기본은 Cloudflare, 또는 직접 릴레이를 가져오세요 ( bore · frp · sish , 모두 오픈소스). 비밀 키가 보이지 않게 함께 탑승합니다 : 당신은 절대 보지 못하며, 무단 침입자는 그저 401에서 피를 흘릴 뿐입니다 . 이름이 마음에 들지 않는다고요? 격식 있는 brigade expose 라는 이름으로도 응답합니다. 🩸

brigade bloody benchmark · brigade expose · brigade expose stop 🩸

Brigade는 엔터프라이즈급 기술 위에 구축된 당신만의 개인 인텔리전스 입니다: 실제 조직도 위에서
하나의 장기 기억, Tideline을 공유하는 AI 에이전트 크루 — 한 에이전트가 배운 것을 나머지가
사용할 수 있습니다. 그들은 서로에게 위임하고, 작업 도중 실마리를 잃지 않고 모델을 전환하며, 당신이 이미 사용하는 1,000개 이상의 앱 안에서 행동합니다. 이것은 당신이 직접 호스팅하는 생태계로, 엔터프라이즈 기술의 통제력과 데이터 주권을 갖춥니다: 생성할 계정도, 중간의 SaaS도 없습니다.

같은 크루가 Raspberry Pi나 서버에서 실행됩니다. 기본적으로는 작은 파일시스템
설치이며, 원할 때 자체 호스팅 Convex 데이터베이스로 전환할 수 있습니다. 어떤 모델이든 가져오세요:
Claude, GPT, Gemini, Llama, 또는 로컬 Ollama. 권한이 필요한 작업은 당신의
승인을 기다리며, 당신의 키와 데이터는 절대 기기를 떠나지 않습니다. 텔레메트리 없음.

앱이 아닌 생태계입니다: 터미널, WhatsApp, Telegram,
Slack, Discord, iMessage, BlueBubbles에서, 그리고 당신의 워치, Meta 스마트 안경, Meta Quest에서 접근하는 하나의 크루.

# macOS / Linux — 필요 시 Node 설치 후 Brigade 설치 (sudo 없음)
curl -fsSL https://brigade.spinabot.com/install.sh | sh
brigade
시작하면 빠른 채팅 TUI가 나타납니다. 계속 나아가면 자체 워크스페이스와 자격 증명을 가진 격리된 에이전트, 영구 기억, 스킬 시스템, cron 스케줄러, 서브 에이전트 팬아웃, 조직 계층, WhatsApp과 Telegram 같은 메시징 채널, 1,000개 이상의 앱 커넥터, MCP 메모리 서버, 그리고 선택적 자체 호스팅 Convex 백엔드를 얻게 됩니다 — 모두 당신이 완전히 소유하는 하나의 ~/.brigade/ 디렉터리 아래에.

한 명의 소유자, 하나의 크루 — 실제 조직도를 통해 조율하는 다수의 에이전트,
모두 당신이 통제하는 하드웨어와 스토리지 위에서.

목차

Brigade를 선택하는 이유
설치
빠른 시작
작동 방식
기능
CLI 레퍼런스
채팅 내 명령
내장 도구
Team Mode
멀티 에이전트 격리
프로바이더 & 웹 검색
구성 & 스토리지
스토리지 모드: 파일시스템 vs. Convex
MCP 메모리 서버
Tideline (장기 기억)
Brigade 확장
프라이버시
소스에서 개발
기여하기
라이선스
🦁 Brigadiers

Brigade를 선택하는 이유

🖥️ 터미널 우선
기본적으로 깜빡임 없는 채팅 TUI. 브라우저 없음, Electron 없음.

🧠 지속되는 기억
사실은 출처 스코핑, 감쇠, 하이브리드 (키워드 + 벡터) 회상과 함께 세션을 넘어 지속됩니다 — Tideline 엔진.

👥 진짜 크루
자체 페르소나, 자격 증명, 기억을 가진 격리된 에이전트를 생성하고, 누가 누구와 대화할 수 있는지를 관장하는 조직도에 연결하세요.

🔌 어떤 모델이든
Anthropic, OpenAI, Gemini, OpenRouter, OrcaRouter, Token Market, Groq, Cerebras, xAI, DeepSeek, Mistral, 로컬 Ollama, 또는 OpenAI 호환 엔드포인트. 대화 도중 전환.

📅 상시 가동
크래시 감독자, cron 작업, OS 서비스 설치와 함께 헤드리스 WebSocket 게이트웨이로 실행.

💬 채널
오늘날 WhatsApp, Telegram, Slack, Discord, iMessage, BlueBubbles에서 크루와 대화하세요; 어댑터 계약은 더 많은 것을 위해 구축되었습니다.

🔗 1,000개 이상의 커넥터
Gmail, Slack, GitHub, Notion, Calendar, Linear… 내장 Composio 도구를 통해.

📄 문서 읽기 & 쓰기
PDF, Office 문서, 이미지, 오디오, 비디오를 보내면 크루가 이해합니다 — 그런 다음 Word, Excel, PowerPoint, PDF 파일을 생성하거나 편집하여 돌려받으세요.

🧩 MCP
어떤 MCP 클라이언트에도 장기 기억을 노출하거나 ( brigade mcp ), MCP 서버를 연결하세요.

🗄️ 당신의 스토리지
기본 파일시스템 모드, 또는 선택적 완전 자체 호스팅 Convex 백엔드 (저장 시 암호화).

🔐 당신의 것
모든 것이 ~/.brigade/ 아래에 있습니다. 키는 로컬에 0600 모드로 저장됩니다. rm -rf ~/.brigade 로 깔끔하게 지워집니다.

설치
가장 빠른 방법 — Node를 대신 처리 (Node 22.12+가 없으면 설치한 후 Brigade):

# macOS / Linux
curl -fsSL https://brigade.spinabot.com/install.sh | sh
# …또는 GitHub에서 바로:
curl -fsSL https://raw.githubusercontent.com/spinabot/brigade/main/packaging/install/install.sh | sh
# Windows (PowerShell)
irm https: // brigade.spinabot.com / install.ps1 | iex
# …또는 GitHub에서 바로:
irm https: // raw.githubusercontent.com / spinabot / brigade / main / packaging / install / install.ps1 | iex
이미 Node 22.12+를 사용 중이신가요? npm에서 바로 설치하세요:

npm i -g @spinabot/brigade

EACCES / permission denied가 발생하나요? Node의 전역 폴더에 관리자 권한이 필요합니다. sudo를 쓰지 마세요 — 위의 curl … | sh 설치 프로그램을 사용하거나 (비공개, 사용자 소유 런타임을 설정하며 root 불필요), npm을 사용자 쓰기 가능한 prefix로 지정하세요: npm config set prefix ~/.npm-global , 그런 다음 ~/.npm-global/bin 을 PATH 에 추가하세요.

그런 다음 온보딩을 실행하세요:

brigade

빠른 시작
# 1. 설정 — 프로바이더 선택, API 키 붙여넣기 (또는 로컬 Ollama 스캔), 모델 선택
brigade onboard

# 2. 상시 가동 게이트웨이 시작 — 크루, 채널, cron 작업이 여기에 있습니다
brigade gateway run

# 3. 크루와 채팅
brigade tui
온보딩 마법사는 다섯 단계를 안내합니다 : (0) 스토리지 모드
(파일시스템 또는 자체 호스팅 Convex), (1) 프로바이더 선택 (Anthropic, OpenAI, Gemini,
OpenRouter, OrcaRouter, Token Market, Ollama 등), (2) 연결 (API 키 붙여넣기,
Claude/ChatGPT/Copilot 구독으로 로그인 , Claude Code 또는 Codex CLI 로그인 재사용, 또는
로컬 Ollama 연결), (3) 기본 모델 선택 , (4) 웹 검색 (검색
백엔드 선택; 키 없는 옵션은 즉시 작동). 이후 실행은 중단한 지점에서 바로 재개됩니다.

brigade tui (또는 그냥 brigade )는 게이트웨이가 아직 실행 중이 아니면 자동으로 시작하므로,
빠른 로컬 세션이라면 2단계를 건너뛸 수 있습니다. 재부팅 후에도 게이트웨이를 유지하려면
brigade gateway install 을 실행하세요 (launchd / systemd / Task Scheduler
서비스 설치).

다른 편리한 진입점:

brigade agent -m " summarize ~/today.md " # 원샷 턴, TUI 없음
brigade connect # 실행 중인 게이트웨이에 클라이언트 연결
brigade doctor # 설치 상태 점검

작동 방식
Brigade는 게이트웨이 (모든 상태를 보유하고 에이전트를 실행하는 장수명 프로세스)로
작동하거나, 그것에 연결하는 얇은 클라이언트로 작동할 수 있는 하나의 바이너리입니다.

┌─────────────────────────── ~/.brigade/ ───────────────────────────┐
│ config · 에이전트별 워크스페이스 · 세션 (JSONL) · 기억 · cron │
└───────────────────────────────────────────────────────────────────┘
▲
│ 읽기/쓰기 (파일시스템 또는 Convex)
┌─────────────────┴─────────────────┐
brigade tui ──ws──▶ │ GATEWAY :7777 │ ◀──ws── brigade connect
brigade chat │ 턴별 에이전트 루프 · 라우팅 │
WhatsApp·Telegram ──▶│ 도구 · 서브 에이전트 · 감독자 │◀──────── cron 작업
MCP 클라이언트 ─stdio──▶ │ (brigade mcp → 메모리 서버) │
└───────────────────────────────────┘

클라이언트는 얇습니다. TUI ( brigade / brigade tui ), brigade connect , 그리고
채널 어댑터는 모두 게이트웨이의 WebSocket 클라이언트입니다. 상태는 오직
게이트웨이에만 존재하며, 클라이언트는 그것을 미러링합니다. 연결을 끊고, 자리를 뜨고, 나중에 다시 연결하세요 — 당신의
에이전트는 계속 실행됩니다.
한 번에 한 턴. 각 메시지는 견고한 에이전트 루프를 통과합니다: 세션 확인,
시스템 프롬프트 조립 (페르소나 + 스킬 + 조직 컨텍스트), 모델 스트리밍,
승인 및 소유권 가드를 통한 도구 호출 실행, 트랜스크립트 지속, 응답.
어디서나 인바운드. WhatsApp 메시지와 TUI 키 입력은
이들을 (에이전트, 세션) 쌍으로 확인하는 동일한 라우팅 파이프라인을 통과하므로, 한 채널의 피어가
다른 채널의 컨텍스트로 새어 들어가지 않습니다.
계속 가동됩니다. 하트비트 파일과 프로세스 외부 감독자가
이벤트 루프가 멈추면 게이트웨이를 재시작합니다; OS별 서비스 설치 프로그램이 로그인 시 시작합니다.

기능
🧠 기억 (Tideline)
출처 (소유자 vs. 채널 피어)로 태그된 파일 기반 사실 ( facts.jsonl )
로, 피어의 사실이 당신의 컨텍스트로 새어 들어가지 않습니다. 사실은 세 계층으로 감쇠하며
쓰기 시 중복 제거되고, 신뢰할 수 없는 출처가 당신의 정체성/선호를 덮어쓰지 못하게 하는
출처 쓰기 게이트 뒤에 있습니다. Tideline 엔진은 하이브리드 회상 (BM25 키워드 + 모델 없는 벡터 레인), 타입 링크 그래프, 그리고
야간 반성/통합 패스를 추가합니다. 자동 회상은 매 턴 전에 출처가 일치하는 사실만 주입합니다. 도구: recall_memory , read_memory , write_memory ,
manage_memory . → docs/tideline.md

🪪 스킬
SKILL.md가 포함된 폴더를 워크스페이스에 넣으면 Brigade가 다음
턴에 발견합니다. 스킬은 프롬프트 상주형입니다 (이름 + 설명 주입; 모델이 필요 시
본문을 읽음). 여섯 개의 발견 루트가 우선순위 순서로 병합되며 OS, 필수 바이너리, 환경 변수, 구성에 대한 자격
필터가 있습니다. 56개의 스킬이 번들로 제공됩니다.
manage_skill 로 관리하세요.

👥 서브 에이전트
자식 에이전트에게 작업을 위임하세요: spawn_agent (단일) 및 spawn_agents (병렬
팬아웃). 깊이 제한 (기본 3) 및 자식 수 제한 (기본 5), 중단 캐스케이드와 자식이 정착하면 부모를 깨우는 완료 브리지 포함.

🏢 조직 / Pride 계층
크루를 실제 조직도 ( cfg.org )로 정의하세요: 구성원, 부서, 보고 라인. A2A (에이전트 간) 정책이 그래프에서 파생되어 어떤
에이전트가 어떤 에이전트에게 메시지를 보낼 수 있는지 관장합니다. brigade org show / explain / doctor 로 검사하거나,
org 도구로 🦁 Pride 차트를 렌더링하세요.

💬 채널
공유 인바운드 파이프라인 (접근 제어, 중복 제거, 중단 트리거, 승인 라우팅)을 가진 타입 지정 채널 어댑터 계약. WhatsApp (Baileys, QR/코드 페어링,
멀티 계정, 재연결 백오프), Telegram (Bot API 토큰, 인라인 버튼
승인, 게이트웨이에서 부트스트랩된 소유자), Slack (Socket Mode, 봇 + 앱
토큰, 채널/스레드 채팅), Discord (봇 토큰, DM/서버/스레드 채팅),
iMessage (imsg CLI 경유, 평문 전용), 그리고 BlueBubbles (macOS
서버, REST-out + webhook-in, 반응/편집/전송 취소)가 오늘날 제공됩니다; 계약은
더 많은 것을 위해 구축되었습니다. 전체 안내는 Telegram 설정을 참조하세요.

⏰ Cron
반복 또는 일회성 작업을 예약하세요: cron 표현식 (IANA 시간대 및
스태거 포함), 고정 간격, 또는 일회성 타임스탬프. 페이로드는 메인 세션으로의 시스템 이벤트,
격리된 세션의 전체 에이전트 턴, 또는 셸 스크립트일 수 있습니다.
작업은 재시작 후에도 유지됩니다.

🔗 커넥터 (Composio)
소유자 전용 composio 도구가 관리형 OAuth와 함께 1,000개 이상의 앱 커넥터 (Gmail, Slack, GitHub,
Notion, Calendar, Linear, …)를 제공합니다. 키를 한 번 설정한 후, 크루에게
평범한 언어로 요청하세요: "connect my Gmail" , "post to #team" .

키 받기: Brigade는 Composio SDK 를 사용하므로 PLATFORM 키
( ak_ 로 시작)가 필요하며, Brigade가 거부하는 "FOR YOU" 소비자 키 ( ck_ )가 아닙니다. dashboard.composio.dev 에서 좌상단 모드 토글을
PLATFORM 으로 설정하고, Settings → API Keys 를 열고 ak_… 키를 복사하세요. Brigade에
한 번 전달하면 ( "set my Composio key to ak_… " ) 검증되어 암호화되어 저장됩니다.
전체 가이드: docs/composio.md .

📄 문서 & 미디어
크루에게 파일을 보내면 실제로 읽습니다: analyze_media 도구는
PDF (텍스트 또는 스캔), Word / Excel / PowerPoint (내부에 포함된 이미지 포함), 일반 이미지, 오디오, 그리고…