teambrain-cli

TeamBrain CLI — push and recall traces from any local project. Pairs with Claude Code (/save, /recall).

Install

npm install -g teambrain-cli
# 또는 pnpm add -g teambrain-cli

Quickstart

# 1. 로그인 (한 번만, 머신당)
tb login
# → 브라우저 열림 → [Approve] 1번 클릭 → 끝

# 2. Claude Code 슬래시 커맨드 글로벌 설치 (한 번만)
tb init
# → ~/.claude/skills/save · recall 자동 배치

# 3. 본인 로컬 프로젝트로 이동 → 워크스페이스에 묶기
cd ~/work/my-app
tb link
# → .teambrain.yml 생성. commit해서 팀 공유.

# 4. 그 디렉토리에서 trace push
echo '{"frontmatter":{"role":"eng","topic":"hello"},"body":"# hi"}' | tb save
# 또는 Claude Code에서 /save

# 5. 과거 trace 회수
tb pull --since 30d
# 또는 Claude Code에서 /recall <키워드>

tb save는 .teambrain.yml을 우선 읽어 워크스페이스를 결정하고, git remote/branch/commit_sha를 frontmatter.project에 자동 첨부합니다.

Commands

| 명령 | 설명 | |---|---| | tb login | device-flow 로그인 (브라우저 [Approve] 1번) | | tb login --paste | fallback — refresh_token devtools paste | | tb status | 로그인 상태 + 현재 디렉토리의 link 상태 | | tb workspace | 멤버 워크스페이스 목록 | | tb workspace use <id> | 글로벌 default ws 변경 | | tb link [<ws>] | 현재 디렉토리를 ws에 묶음 (.teambrain.yml) | | tb init [--force] | ~/.claude/skills/에 /save·/recall 배치 | | tb pull [--since 7d] | ws의 trace를 .teambrain/cache/<id>.md로 가져옴 | |     [--topic kw] | topic ilike 매치 | |     [--role pm\|eng\|...] | 역할 필터 | |     [--limit N] | 기본 100 | | tb save | stdin/-f payload → trace push (project context 자동) | | tb logout | 토큰 삭제 |

env override

TEAMBRAIN_API=https://...    # 기본 endpoint override
TEAMBRAIN_ANON=eyJ...        # 기본 anon key override

Workspace 선택 우선순위 (tb save)

1. payload의 workspace_id
2. ./.teambrain.yml의 workspace_id
3. ~/.teambrain/auth.json의 default workspace_id