Tencent/teamai-cli

TeamAI‑CLI란 무엇인가요?

TeamAI‑CLI는 소프트웨어 팀이 AI 관련 자산(프롬프트, 사용자 지정 에이전트, 규칙, 환경 구성, 모델 참조, 사용 로그까지)을 공유 Git 저장소에 저장된 일급 코드로 취급할 수 있게 하는 명령줄 도구(npm에 게시됨)입니다. 팀원 한 명이 teamai init <repo-url>을 실행하면 도구가 최신 "팀 AI" 파일을 모든 구성원의 로컬 작업 공간에 자동으로 동기화하여 모든 AI 세션(예: Claude, Codex, Cursor 등)이 동일한 스킬, 정책, 모델로 작동합니다.

중요한 이유

일관성 – 모든 팀원이 수동 복사 없이 동일한 프롬프트 라이브러리, 안전 규칙, 모델 버전을 얻습니다.
버전 관리되는 AI 자산 – 스킬, 훅, 모델 참조까지 Git에 저장되어 코드처럼 AI 변경 사항을 검토, 분기, 롤백할 수 있습니다.
무접촉 업데이트 – 초기 설정 후 CLI는 모든 AI 상호 작용 시 새 자산을 가져와 모두를 동기화 상태로 유지합니다.
다양한 AI 에이전트 지원 – README에는 수십 개의 지원 에이전트(Claude, Codex, Cursor, GitHub Copilot CLI 등)가 나열되어 있으며 각각 팀 구성을 자동으로 받습니다.

빠른 시작(AI 어시스턴트용 한 줄 명령)

tteamai 스킬 설치: https://github.com/Tencent/teamai-cli/tree/main/skills/teamai , teamai 스킬을 로드한 다음 팀을 위해 TeamAI를 처음부터 설정합니다.

어시스턴트가 위 명령을 실행한 후 간단한 채팅 명령으로 팀을 관리할 수 있습니다. 예:

/teamai 팀을 위해 TeamAI를 처음부터 설정하는 것을 도와줘
/teamai 내 팀의 TeamAI에 가입하는 것을 도와줘, 저장소 URL은 https://github.com/your-org/your-repo
/teamai 내 xxx 스킬을 팀과 공유
/teamai TeamAI 대시보드 열기

설치

# npm을 통한 전역 설치
npm install -g teamai-cli

핵심 워크플로우

공유 Git 저장소 생성(GitHub, GitLab, GitCode, CNB, TGit 또는 모든 프라이빗 Git 서비스). 기본 브랜치를 보호하고 팀원에게 푸시 권한을 부여합니다.
초기화 – 작업 공간 디렉터리(기본값)에서 teamai init <repo-url>을 실행하거나 --scope user를 사용하여 ~/ 아래에 설치합니다.
팀 관리자는 teamai-hub 조직의 기성 템플릿에서 시작하여 포크할 수 있습니다.
팀원은 동일한 teamai init 명령을 실행하기만 하면 됩니다. CLI가 저장소를 복제하고 로컬 훅을 설정합니다.
모든 AI 세션은 이제 최신 스킬, 규칙, 환경 정의, 모델 참조 및 기타 자산을 자동으로 가져옵니다.

주요 기능(Git 위에 계층화)

계층	기능
팀 실행	스킬, 규칙, 환경 변수, 에이전트, 훅, MCP 서버, 모델 참조를 각 팀원의 AI 도구에 배포합니다.
팀 컨텍스트(베타)	에이전트에 공유 학습, 코드베이스 그래프, 팀 위키를 제공하여 모델이 팀 특정 지식으로 답변할 수 있게 합니다.
팀 개선(베타)	사용 메트릭과 세션 로그를 수집하여 팀이 AI 사용 방식과 개선할 부분을 이해하도록 돕습니다.

지원 에이전트(발췌)

에이전트	스킬	규칙	환경	에이전트	훅	MCP	모델
Claude Code	✅	✅	✅	✅	✅	✅	✅
Codex	✅	✅¹	✅	✅	✅	✅	✅
Cursor	✅	✅	✅	✅	✅	✅	—
GitHub Copilot CLI	✅	✅	✅	✅	✅	✅	—
…(더 많음)

*¹ 규칙은 파일 경로와 관계없이 유지됩니다. *² 환경 변수는 teamai env exec를 통해서만 적용됩니다.

문서 및 학습 리소스

시작하기 – docs/guide/getting-started.md
사용 가이드 – 일상 워크플로우 및 명령 참조(docs/usage-guide.md)
제품 개요 – 아키텍처 및 배포 제어(docs/product-overview.md)
Git 제공자 – 지원되는 호스팅 서비스(docs/guide/providers.md)
Windows 설정 – 훅 및 셸에 대한 특별 참고 사항(docs/guide/windows.md)
기술 설계 – 더 깊은 설계 문서(docs/designs/README.md)

누가 유지 관리하나요?

이 프로젝트는 MIT 라이선스 하에 오픈소스이며 Tencent가 작성했습니다. 일반적인 GitHub 워크플로우(이슈, PR, CONTRIBUTING.md 가이드)를 통해 기여를 환영합니다. 기여자 배지는 커뮤니티 활동을 보여줍니다.

요약

TeamAI‑CLI는 Git 저장소를 팀이 사용하는 모든 AI 자산의 단일 진실 소스로 전환합니다. 전역으로 설치하고 공유 저장소를 지정하면 모든 팀원의 AI 도구가 팀의 프롬프트, 정책, 모델 및 사용 분석과 자동으로 동기화됩니다.