open-gitagent/gitagent

어떤 프로젝트인가요?

핵심 기능

• 01에이전트의 정체성, 규칙, 메모리, 도구를 git으로 버전 관리되는 파일에 저장합니다.
• 02도구 호출을 제어하고 수정하는 훅을 제공하는 스트리밍 SDK query()를 지원합니다.
• 03로컬 디렉터리에서 실행하거나 GitHub 저장소를 세션 브랜치에 클론합니다.
• 04MCP 클라이언트로 동작하며 설정된 서버의 도구를 자동 등록합니다.
• 05선언형 YAML 도구, 스킬, 플러그인을 지원합니다.
• 06선택적 OpenTelemetry 트레이싱과 감사 로깅을 지원합니다.

활용 사례

• 규칙과 메모리를 git diff로 검토할 수 있는 개인용 또는 팀용 AI 어시스턴트를 관리합니다.
• 기본 에이전트를 포크하고 성격이나 규칙이 다른 변형을 브랜치로 만듭니다.
• 에이전트를 GitHub 저장소에서 실행해 세션 브랜치에서 수정 작업을 합니다.
• query() SDK와 사용자 지정 도구를 사용해 Node.js 앱에 에이전트를 통합합니다.

빠른 시작

1. 1

   npm으로 CLI와 SDK를 설치하세요

   npm install -g @open-gitagent/gitagent
2. 2

   OpenAI API 키를 설정하세요

   export OPENAI_API_KEY="sk-..."
3. 3

   프로젝트 디렉터리에서 첫 번째 에이전트를 실행하세요

   gitagent --dir ~/my-project "Explain this project and suggest improvements"

사용 전 알아둘 점

• !에이전트를 실행하려면 OpenAI 또는 Anthropic과 같은 모델 제공업체의 API 키가 필요합니다.
• !음성 모드와 웹 UI는 별도 패키지인 @open-gitagent/voice에 포함되어 있으며, 따로 설치해야 합니다.

토픽

자주 묻는 질문

gitagent은(는) 무엇인가요?

에이전트의 정체성, 규칙, 메모리, 도구, 스킬을 저장소의 버전 관리 파일로 관리하는 git 네이티브 AI 에이전트 프레임워크입니다. Gitagent는 AI 에이전트를 git 저장소로 다룹니다. 에이전트의 성격(SOUL.md), 행동 규칙(RULES.md), 메모리(memory/), 선언형 YAML 도구, 조합 가능한 스킬과 라이프사이클 훅이 모두 일반 파일로 저장되므로, 일반적인 git 명령만으로 에이전트를 포크하고 브랜치를 만들고 변경 사항을 비교하거나 내용을 살펴볼 수 있습니다.

gitagent은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

gitagent은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

gitagent은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. gitagent의 마지막 커밋은 2026년 10월 22일입니다.

gitagent은(는) 어디에 사용할 수 있나요?

규칙과 메모리를 git diff로 검토할 수 있는 개인용 또는 팀용 AI 어시스턴트를 관리합니다. 기본 에이전트를 포크하고 성격이나 규칙이 다른 변형을 브랜치로 만듭니다. 에이전트를 GitHub 저장소에서 실행해 세션 브랜치에서 수정 작업을 합니다. query() SDK와 사용자 지정 도구를 사용해 Node.js 앱에 에이전트를 통합합니다.

gitagent는 어떻게 설치하나요?

npm으로 CLI와 SDK를 설치하세요: npm install -g @open-gitagent/gitagent OpenAI API 키를 설정하세요: export OPENAI_API_KEY="sk-..." 프로젝트 디렉터리에서 첫 번째 에이전트를 실행하세요: gitagent --dir ~/my-project "Explain this project and suggest improvements"

gitagent은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/open-gitagent/gitagent