Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
GitBot은 코딩 에이전트를 여러 저장소(repos)에 걸쳐 작업할 수 있게 돕는 도구입니다. 이 봇을 사용하면 한 번만 설정한 에이전트가 재사용 가능한 임무와 대화를 통해 다양한 프로젝트에서 일관되게 작업을 수행하도록 할 수 있습니다. Node.js 18 이상 버전과 코딩 에이전트 로그인이 필요하며, 사용자 권한으로 모든 작업이 통제됩니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기npm version
npm downloads
Node.js 18+
MIT license
GitHub stars
봇을 한 번만 만드세요. 코딩 에이전트를 여러 저장소(repos)에 걸쳐 작업하게 하세요.
GitBot은 사용자의 컴퓨터에서 Claude Code, Codex 또는 OpenCode를 실행하고 각 에이전트에게 재사용 가능한 임무, 작업할 장소, 그리고 돌아갈 수 있는 대화를 제공합니다. 사용자만이 권한을 통제합니다.
npm install -g @gitbot-hq/gitbot
<br><br>
<picture><source media="(prefers-color-scheme: dark)" srcset="assets/screenshots/hub.webp"><source media="(prefers-color-scheme: light)" srcset="assets/screenshots/hub-light.webp"><img src="https://raw.githubusercontent.com/gitbot-hq/GitBot/HEAD/assets/screenshots/hub-light.webp" alt="봇, 스레드 및 대화가 있는 GitBot 작업 공간"></picture>
<br><br><br>
Node.js 18 이상 버전과 로그인된 코딩 에이전트가 최소 하나 필요합니다. GitBot은 사용자가 기존에 설정한 에이전트 로그인을 사용하므로, 별도의 GitBot 계정을 만들도록 요구하지 않습니다.
| 에이전트 | 시작하기 전에 |
|---|---|
| Claude Code | claude CLI를 설치하고 로그인하세요. |
| ... | |
| 설치 후, 프로젝트가 있는 폴더에서 다음 명령을 실행하여 GitBot을 시작합니다: |
npm install -g @gitbot-hq/gitbot
cd /path/to/your/projects
gitbot start
컴퓨터에서 **http://localhost:3000**으로 접속하세요. GitBot은 동일한 신뢰 네트워크에 있는 다른 장치에서 연결하려면 네트워크 주소와 QR 코드를 출력합니다. 작업 공간은 데스크톱에서 가장 잘 작동합니다.
다른 장치를 연결하기 전에: GitBot에는 인증 기능이 없습니다. 포트에 접근할 수 있는 사람은 누구나 사용자의 기기에서 실행되는 에이전트를 사용할 수 있습니다. 신뢰 네트워크에 두고 공용 인터넷에 절대 포트를 노출하지 마세요. 보안 및 개인 정보 보호 참고 사항를 읽어보세요.
<br><br><br>
봇(bot)은 코딩 에이전트(coding agent)를 위한 재사용 가능한 일련의 지침입니다. 사용자가 무엇을 할지, 어떤 에이전트가 이를 실행할지, 그리고 질문 없이 무엇을 할 수 있게 할지를 결정합니다.
<p align="center"> <img src="https://raw.githubusercontent.com/gitbot-hq/GitBot/HEAD/assets/mascots/ghost.webp" width="80" alt="Ghost GitBot mascot"> <img src="https://raw.githubusercontent.com/gitbot-hq/GitBot/HEAD/assets/mascots/star.webp" width="80" alt="Star GitBot mascot"> <img src="https://raw.githubusercontent.com/gitbot-hq/GitBot/HEAD/assets/mascots/cat.webp" width="80" alt="Cat GitBot mascot"> </p>첫 봇의 경우, 다음과 같은 지침을 시도해 보세요:
현재 저장소에서 코드와 더 이상 일치하지 않는 문서를 검토합니다.
가장 먼저 구체적인 불일치 사항 하나를 식별하세요. 그것을 설명하고, 작은 수정 사항을 제안하며, 파일을 편집하기 전에 질문하세요.
이 지침은 봇에게 임무를 부여합니다. 당신의 메시지는 오늘 할당할 과제를 부여합니다. 스레드는 그 작업을 함께 유지하므로 나중에 다시 돌아와 작업할 수 있습니다.
| 생성 방법 선택 | 봇 정의 | 스레드 시작 |
|---|---|---|
| <picture><source media="(prefers-color-scheme: dark)" srcset="assets/screenshots/create-menu.webp"><source media="(prefers-color-scheme: light)" srcset="assets/screenshots/create-menu-light.webp"><img src="https://raw.githubusercontent.com/gitbot-hq/GitBot/HEAD/assets/screenshots/create-menu-light.webp" alt="Bots 패널에서 봇을 생성, 생성 또는 가져오기"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="assets/screenshots/create-bot-form.webp"><source media="(prefers-color-scheme: light)" srcset="assets/screenshots/create-bot-form-light.webp"><img src="https://raw.githubusercontent.com/gitbot-hq/GitBot/HEAD/assets/screenshots/create-bot-form-light.webp" alt="이름, 에이전트, 지침, 권한 및 마스코트로 봇 생성"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="assets/screenshots/create-thread.webp"><source media="(prefers-color-scheme: light)" srcset="assets/screenshots/create-thread-light.webp"><img src="https://raw.githubusercontent.com/gitbot-hq/GitBot/HEAD/assets/screenshots/create-thread-light.webp" alt="새 스레드를 위해 작업 공간 및 에이전트 선택"></picture> |
또한 **에이전트로 생성(Create with an agent)**을 선택하여 설치된 에이전트에 안내 작성 프롬프트를 제공하거나, 누군가 코드를 공유했다면 **봇 가져오기(Import bot)**를 할 수 있습니다. 두 경우 모두 봇이 작업하도록 하기 전에 봇의 지침과 권한을 검토하세요.
<br><br><br>
스레드를 시작할 때 저장소(repo)를 선택하세요. 봇은 해당 폴더에서 에이전트를 실행하고 대화 내용을 GitBot으로 스트리밍합니다. 브라우저 탭을 닫고 나중에 진행 중이던 턴으로 돌아올 수 있습니다.
Claude Code나 OpenCode의 경우, 도구 사용에 권한이 필요할 때 GitBot이 승인 카드(approval card)를 보여줍니다. Codex는 액션별 승인 채널이 없기 때문에, 선택된 권한 모드가 대신 샌드박스(sandbox)를 선택합니다.
A GitBot working through a task in a conversation
GitBot은 사용자의 브라우저와 기기에 이미 설치된 코딩 에이전트 사이의 로컬 서버 역할을 합니다:
Browser -> 기기의 GitBot -> Claude Code, Codex, 또는 OpenCode
| |
+-- 봇 및 스레드 +-- 사용자의 저장소에서 작동
**코드와 공유(Share with code)**는 봇의 설정과 지침을 복사하여 다른 사람이 가져올 수 있도록 합니다. 여기에는 채팅 기록이나 로컬 파일은 포함되지 않습니다. 공유하기 전에 개인 정보가 있는지 지침을 확인하세요.
**마켓플레이스에 게시(Publish to Marketplace)**는 사용자가 검토하고 봇과의 대화에 복사할 수 있는 프롬프트를 보여줍니다. 봇이 공개 목록 초안을 작성하고 풀 리퀘스트(pull request)를 준비할 수는 있지만, 반드시 사용자에게 목록과 최종 diff를 보여주고 승인을 기다려야 합니다. 이 프롬프트를 복사하는 것은 아무것도 게시하지 않습니다.
직접 리스팅을 제출하는 것을 선호하십니까? GitBot 라이브러리 게시 가이드를 확인하세요. 마켓플레이스 봇은 해당 저장소의 bots/<slug>/ 아래에 존재하며 풀 리퀘스트(pull requests)를 통해 검토됩니다.
| 공유 방법 선택 | 코드로 공유 | 마켓플레이스에 게시 |
|---|---|---|
| <picture><source media="(prefers-color-scheme: dark)" srcset="assets/screenshots/share-menu.webp"><source media="(prefers-color-scheme: light)" srcset="assets/screenshots/share-menu-light.webp"><img src="https://raw.githubusercontent.com/gitbot-hq/GitBot/HEAD/assets/screenshots/share-menu-light.webp" alt="봇을 코드 또는 마켓플레이스에 공유하기"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="assets/screenshots/share-code.webp"><source media="(prefers-color-scheme: light)" srcset="assets/screenshots/share-code-light.webp"><img src="https://raw.githubusercontent.com/gitbot-hq/GitBot/HEAD/assets/screenshots/share-code-light.webp" alt="생성된 코드를 사용하여 봇 공유하기"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="assets/screenshots/publish-marketplace.webp"><source media="(prefers-color-scheme: light)" srcset="assets/screenshots/publish-marketplace-light.webp"><img src="https://raw.githubusercontent.com/gitbot-hq/GitBot/HEAD/assets/screenshots/publish-marketplace-light.webp" alt="에이전트 또는 수동으로 마켓플레이스에 봇 게시하기"></picture> |
| <br><br><br> |
Claude Code나 OpenCode의 경우 **도구 사용 전 질문(Ask before tools)**부터 시작하세요. Codex의 경우 편집을 원하지 않으면 **읽기 전용(Read-only)**을 사용하세요. 봇의 지침을 이해하고 작업하는 저장소를 신뢰할 때만 더 광범위한 권한으로 이동하세요. 스레드의 권한 모드는 채팅 표시줄에서 변경할 수 있습니다. Codex와 Plan 변경 사항은 다음 메시지부터 적용되며, 더 광범위한 Claude Code 또는 OpenCode 모드도 현재 답장에 이미 대기 중인 승인을 해결할 수 있습니다.
| Claude Code | OpenCode | Codex | |
|---|---|---|---|
| 승인 요청 (Approval requests) | 도구가 필요로 할 때 | 도구가 필요로 할 때 | 아니요; 선택한 모드가 샌드박스를 선택합니다 |
| ... | |||
| An 허용된 도구(Allowed tools) 목록은 봇이 사용할 수 있는 도구를 제한하며, 권한 모드는 언제 요청할지 결정합니다. Codex는 이 목록을 강제할 수 없으므로 엄격한 도구 격리(tool fence)가 중요한 경우에는 Claude Code 또는 OpenCode를 선택하세요. |
<br><br><br>
중요: GitBot은 인증 기능이 없으며 모든 네트워크 인터페이스에서 수신합니다. 포트에 접근할 수 있는 사람은 누구나 귀하의 기기 액세스를 사용하여 에이전트를 실행할 수 있습니다. 신뢰하는 네트워크를 사용하고, 포트를 인터넷에 노출하지 않으며, 사용하지 않을 때는 GitBot을 중지하세요.
봇은 귀하의 사용자 계정 파일 및 셸 접근 권한으로 작동합니다. 자동 승인(Auto-approval)은 개별 도구 호출을 검사할 기회를 제거합니다. 가져온 봇(Imported bots)에는 가져올 때 실행되는 설정 지침이 포함될 수 있으므로, 먼저 이를 읽고 그 권한 모드를 확인하세요.
GitBot은 계정, 원격 측정(telemetry), 또는 호스팅된 데이터베이스가 없습니다. 봇과 스레드 기록은 기본적으로 ~/.gitbot 아래에 저장됩니다. 선택한 에이전트는 제공업체 구성에 따라 프롬프트와 코드를 전송합니다. GitBot은 또한 시작 시 공용 IP를 조회하여 네트워크 주소를 출력합니다.
<br><br><br>
gitbot start # 포트 3000 사용
gitbot start -p 4000 # 다른 포트 선택
gitbot start --caffeinate # 장시간 작업 중 Mac 깨어있게 유지
gitbot start를 실행하는 폴더가 폴더 선택기에서 가장 먼저 표시되는 작업 공간이 됩니다. 스레드는 여전히 읽을 수 있는 다른 폴더에서 실행될 수 있습니다.
<br><br><br>
| 만약 ... 이 보인다면 | 이렇게 시도해 보세요 |
|---|---|
| 메뉴에 에이전트가 누락된 경우 | CLI를 설치하고 로그인한 후 GitBot을 다시 시작하세요. |
| ... | |
| 구현 세부 정보는 API 참조, 아키텍처 노트, 봇 작성 프롬프트, 및 웹 UI 가이드를 참고하세요. |
<br><br><br>
GitBot은 오픈 소스입니다. 사소한 수정 이상의 변경을 원하시면, 먼저 이슈를 열어주세요. 변경 사항에 집중하고, 빌드 및 TypeScript 검사를 실행하며, 풀 리퀘스트(pull request)에서 테스트한 동작을 설명해 주세요.
<br><br><br>