b3os-team-inboxlisted
Install: claude install-skill b3rys/b3rys-team-os
# b3os-team-inbox
the team lead AI Team message bus 의 클라이언트 도구.
## 언제 쓰는가
- **사용자가 Slack/Telegram 으로 thread_id 와 함께 메시지를 보내왔을 때** → `send.sh` 로 답
**★답할 때는 `--in-reply-to <그 메시지 id>` 를 붙인다.★**
그래야 서버가 "이 답이 ★어느 질문★ 에 대한 것인지" 를 안다. 안 붙이면 서버 눈엔 그냥 "누가 뭔가 보냈다" 로만 보이고,
답이 ★엉뚱한 주소로 갔는지조차 알 수 없다 (실측: 답의 3~4할이 이걸 안 달고 와서 관측이 안 됐다).
```bash
send.sh --to <물어본 사람> --thread <온 thread> --in-reply-to <그 메시지 id> --body "..."
```
- **inbox 확인** ("새 메시지 있나?") → `inbox.sh`
- **다른 agent 와 토론 시작** → `send.sh --to <other_agent> --body "..."`
- **팀장께 최종 보고** → `send.sh --to <요청자> --thread <온 thread> --in-reply-to <그 메시지 id> --direct-to-gd --body "..."`
★`--direct-to-gd` 는 '★내가★ 하는 최종 보고' 전용이다★ — 서버가 이 봉투의 본문을 팀장 1:1 DM 에 게시한다.
· **`--to` 와 `--in-reply-to` 가 둘 다 필요하다.** 보고는 '받은 요청에 대한 답' 이라서다.
`--in-reply-to` 없이 붙이면 서버가 400(`protocol_direct_to_gd_on_delegation`)으로 거부한다.
· **팀원에게 "팀장께 보고해줘" 를 시키는 위임이면 이 플래그를 쓰지 않는다** — `--to <팀원>` 으로 보내고
본문에 그렇게 쓴다. 플래그는 그 팀원이 ★자기 답에★ 붙인다.
- **메시지 읽음 처리** → `ack.sh`
- **팀버스 맥락 조회** ("팀버스 그거 어떻게 됐어?", "GD가 코덱스한테 뭐 시켰어?") → `bus-recall.sh` (read-only, team.db 조회. 뒤지기 대신 요점 확인)
서버: `http://127.0.0.1:7878/team/api/inbox` (loopback).
## 자기 id 자동 감지
스크립트는 현재 tmux session 이름에서 agent id 를 자동 감지한다.
- `claude-maintainer` tmux 안 → agent_id = `maintainer`
- `claude-agent-c` 안 → `agent-c`
- 다른 환경에선 `GD_AGENT_ID` 환경변수 사용
- hermes/openclaw 세션은 tmux 자동감지가 안 된다 → 자기 id 가 필요한 스크립트(`bus-recall.sh` 등)에는 `--me <내 agent id>` 를 붙인다. (예: `bus-recall.sh --me ames --with