Tencent/teamai-cli

TeamAI CLI – AI 어시스턴트 도구를 위한 공유 리포지토리 관리자

무엇인가요

• npm을 통해 배포되는 명령줄 도구(teamai-cli)로, 다양한 AI 코딩 어시스턴트(Claude Code, Codex, Cursor, Qoder, CodeBuddy, OpenCode, WorkBuddy 등)가 사용하는 스킬, 규칙, 문서, 환경 설정, 훅, 기타 리소스를 팀 전체에서 동기화할 수 있게 해줍니다.
• 리소스는 공유 Git 리포지토리(GitHub, GitLab, GitCode, CNB, TGit, 또는 기타 사내 Git 서비스)에 저장됩니다. 팀원들은 변경 사항을 머지 요청(MR)으로 푸시하고, 머지되면 teamai pull이 자동으로 각 로컬 AI 도구에 업데이트를 적용합니다.

핵심 개념

계층	목적	CLI 지원
팀 실행	모든 에이전트가 팀의 규칙(스킬, 규칙, 문서, 환경, 훅, MCP 서버)을 따르게 함	init, pull, push, install, hooks, mcp, source
팀 컨텍스트	에이전트에게 공유 지식 기반(학습된 세션, 코드베이스 그래프, 팀 위키)을 제공	recall, import, codebase --lint
팀 개선	번거로운 세션을 팀 전체의 학습과 대시보드로 전환	session save, digest, dashboard, recall promote/maintenance

주요 기능

• 분산형 스킬/훅 리포지토리 – Claude, Codex, Cursor 등의 스킬 파일을 ~/.<agent>/skills/에 저장하고 버전 관리 가능하게 합니다.
• 역할 및 태그 기반 필터링 – 관리자가 각 역할이나 태그가 어떤 스킬을 받을지 정의할 수 있습니다(teamai roles, teamai tags).
• 소스 구독 – 다른 팀이나 공유 조직 리포지토리에서 추가 스킬 리포지토리를 가져올 수 있습니다(teamai source add …).
• MCP(Model-Control-Plane) 서버 설정 – 원격 추론 엔드포인트를 한 번 선언하면 각 도구의 네이티브 설정에 자동으로 기록됩니다.
• 자동 세션 학습 – 세션이 "마찰"(인터럽트, 도구 재시도, 수정)을 겪으면 CLI가 경험을 요약하고 리포지토리에 푸시할 것을 제안할 수 있습니다.
• 팀 지식 그래프 – teamai import는 소스 코드를 파싱(타입스크립트/자바스크립트/파이썬/고는 Tree-Sitter를 통해 AST, 기타 언어는 히ュ리스틱 정규식)하여 teamwiki/ 아래에 그래프로 저장합니다. 이 그래프는 리콜 결과의 재순위에 사용됩니다.
• 리콜 서브에이전트 – 선택적 플러그인으로, 지원되는 모든 AI 도구가 작업을 수행하기 전에 공유 지식 기반을 질의할 수 있게 합니다(teamai recall enable).
• 대시보드 및 요약 – 주간 사용 보고서, 실시간 세션 상태, KB 건강 페이지를 통해 토큰 소비량, 개입률, 지식 기반 커버리지를 팀이 모니터링할 수 있습니다.
• CI 통합 – teamai ci extract-mr는 머지 요청 논의에서 지식을 자동으로 추출하고 댓글을 게시할 수 있습니다.

일반적인 워크플로우

1. 공유 리포지토리 생성 (또는 teamai-hub 조직의 템플릿 사용).
2. teamai init <repo-url> 실행 – 로그인, 사용자 등록, 초기 훅 삽입.
3. 로컬에서 스킬/규칙 편집 또는 추가 후 teamai push → 검토를 위한 머지 요청 열기.
4. MR가 머지되면, 모든 멤버의 다음 AI 세션에서 teamai pull이 자동 실행(세션 시작 훅을 통해)되어 최신 리소스가 로컬 AI 도구에 동기화됩니다.
5. 세션이 "마찰이 많은" 경우, /teamai-share-learnings 또는 teamai session save를 실행하여 요약을 캡처하고 새로운 지식 항목으로 등록.
6. 정기적으로 teamai digest 실행 또는 teamai dashboard 열어 팀 전체 메트릭과 KB 건강 상태 확인.

설치

npm install -g teamai-cli   # Node.js 필요

설치 후 teamai init …을 실행할 수 있습니다.

지원되는 AI 에이전트(README 기준) – Claude Code, Codex, Cursor, Qoder, CodeBuddy, OpenCode, WorkBuddy, OpenClaw, Hermes, DeepSeek Harness. README의 표에는 각 에이전트에서 현재 구현된 기능(스킬, 규칙, 문서, 환경, 에이전트, 훅, MCP)이 나와 있습니다.

라이선스

• MIT (LICENSE 참조).

누가 사용할 수 있나요

• AI 코딩 어시스턴트에 크게 의존하고 프롬프트, 플러그인, 정책의 단일 진실원칙을 원하는 엔지니어링 팀.
• AI 생성 코드 리뷰 또는 디버깅 규칙을 역할 기반으로 배포해야 하는 조직.
• AI 지원 디버깅 세션에서 얻은 "트라이벌 지식"을 캡처하고 재사용하고자 하는 팀.

---

위 모든 세부 정보는 리포지토리의 README에서 직접 가져온 것이며, 추가 기능은 추측되지 않았습니다.