GitBot
gitbot-hq · 코딩 · 생산성
GitBot은 Claude Code, Codex, OpenCode를 재사용 가능한 봇으로 바꾸는 오픈소스 로컬 서버다. 지시와 승인 규칙을 저장하고 스레드는 나중에 이어서 쓸 수 있다.
GitBot 소개
About
GitBot이란
GitBot은 내 컴퓨터에 설치하는 작은 서버다. 브라우저 탭과 이미 결제 중인 코딩 에이전트 사이에 놓이고, 그 에이전트가 할 일을 봇으로 저장한다. 봇은 어느 저장소에서든 다시 돌릴 수 있다. GitBot 계정은 필요 없다. 파일은 제자리에 남고, 바깥으로 나가는 연결은 에이전트가 원래 하던 것뿐이다.
해결하려는 문제는 반복이다. Claude Code도 Codex도 OpenCode도 지난번 지시를 잊는다. 그래서 매번 리뷰를 어떻게 해 달라, 어떤 파일이 중요한지, 허락 없이 건드려도 되는 범위가 어디까지인지 다시 설명하게 된다. GitBot은 그 준비를 봇에 담아 두고, 일이 다시 생기면 폴더에 스레드를 연다.
구조를 완성하는 부품이 둘 더 있다. 스레드는 저장소에 묶인 대화이고, 첫 턴을 실행한 에이전트에 그대로 붙어 있다. 탭을 닫아도 돌고 있는 응답으로 돌아올 수 있다. 설정 단계는 컴퓨터마다 한 번만 도는 선택 명령이다. 도구가 설치됐는지 확인하거나 실제 작업 전에 로컬 환경을 준비하는 데 쓴다.
설치 전에 한계를 알아 두자. GitBot에는 인증이 없고 모든 네트워크 인터페이스에서 요청을 받는다. 포트 3000에 닿는 사람은 내 파일과 셸 권한으로 에이전트를 돌릴 수 있다. MIT 라이선스의 0.0.x 버전이라 기능 폭도 좁고 거친 부분도 남아 있다.
시작하기
- Node.js 18 이상과 코딩 에이전트 하나를 준비한다.
claudeCLI,codex login을 마친codex,opencode auth login을 마친opencode중 하나다. - 터미널에서
npm install -g @gitbot-hq/gitbot을 실행한다. - 프로젝트가 있는 폴더로 이동해
gitbot start로 로컬 AI 에이전트 서버를 띄운다. 포트를 바꾸려면-p 4000, 긴 작업 중 Mac이 잠들지 않게 하려면--caffeinate를 붙인다. - 같은 컴퓨터에서
http://localhost:3000을 열고 Bots 패널의 더하기를 눌러 Create manually를 고른다. - 봇 이름을 정하고 설치된 에이전트를 고른 뒤 고정 지시를 쓴다. 봇 권한은 Ask before each tool에 둔다. 이어서 스레드를 열고 저장소 폴더를 선택해 첫 메시지를 보낸다.
제품 정보
GitBot의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- Claude Code, Codex, OpenCode를 이미 결제하는 개발자. GitBot은 기존 로그인을 그대로 쓰므로 추가 비용이 없다.
- 저장소 여러 개를 혼자 관리하는 메인테이너. 문서용 봇과 의존성용 봇을 하나씩 두면 매주 같은 지시를 다시 칠 일이 없다.
- 공유 루틴은 원하지만 호스팅 플랫폼은 원하지 않는 작은 팀. 봇을 코드로 내보내 동료가 가져오면 되고, 운영할 서버가 없다.
작업
- 반복되는 코드 리뷰. 규칙을 한 번 쓰고, 다른 브랜치를 봐야 할 때 봇의 대상 폴더만 바꾼다.
- 문서 정리. README와 코드를 비교하는 봇이 어긋난 지점 하나를 찾아 설명하고, 고치기 전에 물어본다.
- 의존성과 빌드 잡일. 설정 단계가 최초 준비를 맡고, 스레드가 기록을 한곳에 모아 둔다.
활용 상황
- 고객 저장소 세 개를 오가는 프리랜서. 봇마다 그 고객의 관례가 들어 있어 맥락 전환에 클릭 한 번이면 되고 새 브리핑이 필요 없다.
- 이미 에이전트에 로그인된 노트북. 올릴 것도, 두 번째 청구서도 없다. 비밀유지계약이 걸린 코드에서 특히 중요하다.
- 소파에서 지켜보고 싶은 긴 리팩터링. GitBot이 네트워크 주소와 QR 코드를 찍어 주므로 같은 스레드가 도는 동안 휴대폰으로 읽으면 된다.
주요 기능
같은 프롬프트를 다시 붙이지 않는 봇
봇은 고정 지시에 에이전트 선택, 권한 모드, 선택적 설정 단계를 묶은 것이다. 할 일을 일상적인 말로 한 번 쓰면 읽을 수 있는 저장소 어디서든 다시 쓴다. 나누는 지점이 핵심이다. 봇은 일하는 방식을 정하고, 내 메시지는 오늘의 일을 정한다. 프롬프트 파일과 재사용 가능한 AI 코딩 봇의 차이가 여기에 있다. 준비가 다시 붙여 넣는 글자가 아니라 저장된 객체가 된다.
폴더에 묶인 스레드
스레드는 시작할 때 고른 저장소 폴더 안에서 돈다. GitBot은 에이전트 출력을 브라우저로 흘려보내고, 대화는 탭을 닫아도 살아남는다. 긴 턴을 지켜볼 필요가 없다. 스레드는 첫 턴을 실행한 에이전트에 남으므로 모델별 동작도 예측하기 쉽다.
승인 카드와 도구 제한
Claude Code와 OpenCode에서는 도구가 권한을 요구할 때마다 승인 카드가 뜬다. 허용 도구 목록은 봇이 호출할 수 있는 범위 자체를 좁힌다. 자동 승인도 고를 수 있지만, 개별 호출을 확인할 기회는 사라진다. 먼저 질문 모드로 시작하고 익숙해진 뒤 넓히는 편이 낫다.
에이전트별 권한 모드
Codex는 방식이 다르고 GitBot도 그대로 반영한다. Claude Code 봇과 OpenCode 봇에는 승인 카드가 뜨지만 Codex 봇에는 작업별 승인 통로가 없다. Codex에서는 읽기 전용인 Plan only나 폴더 안 편집을 허용하는 Edit in the working directory를 고른다. 모델 지정은 Claude Code와 Codex에서 선택이고, OpenCode에서는 제공자와 모델 쌍으로 필수다.
공유하는 봇과 Marketplace
Share with code는 봇의 지시와 설정을 동료가 가져올 수 있는 코드로 복사한다. 채팅 기록과 로컬 파일은 남는다. Publish to Marketplace는 공개 목록 초안과 GitBot Library 저장소로 보낼 pull request를 만들고, 공개 전에 최종 diff를 보여줘야 한다.
로컬 저장과 계정 없음
봇과 스레드 기록은 기본으로 ~/.gitbot 아래에 있다. GitBot은 호스팅 데이터베이스를 두지 않고, 텔레메트리를 모으지 않으며, 가입도 요구하지 않는다. 시작할 때 공인 IP를 한 번 조회하는데, 같은 네트워크의 다른 기기가 열 주소를 찍기 위해서다.
장단점
장점
- 이미 내는 에이전트를 그대로 쓰므로 청구서가 일정하다. 두 번째 구독을 정당화할 필요가 없다.
- 지시와 권한, 설정 단계가 한곳에 모여 AI 개발 워크플로가 개인 채팅 기록에 기대지 않고 팀이 반복하는 절차가 된다.
- 브라우저를 닫아도 스레드가 이어져 긴 리팩터링에 탭을 열어 둘 필요가 없다.
- 코드가 MIT 라이선스로 공개돼 읽을 수 있다. 내 컴퓨터에서 무엇이 도는지 확인한 뒤 신뢰하기 좋다.
- 내보내기와 가져오기로 인수인계가 쉽다. 동료가 받는 것은 프롬프트 화면 캡처가 아니라 봇 설정 그대로다.
단점
- 인증이 전혀 없다. 포트에 닿는 사람은 내 계정의 파일과 셸 권한으로 에이전트를 돌릴 수 있어 신뢰할 수 있는 네트워크에서만 써야 한다.
- 모델은 포함하지 않는다. Claude Code, Codex, OpenCode 중 하나가 설치되고 로그인돼 있지 않으면 실행할 것이 없다.
- Codex는 허용 도구 목록을 적용하지 않고 작업별 승인도 없다. 도구를 엄격히 막으려면 Claude Code나 OpenCode를 골라야 한다.
- 가져온 봇에는 가져오는 순간 실행되는 설정 명령이 들어 있을 수 있고, 0.0.x 버전 번호가 말하듯 원격 접근 제어 같은 편의 기능은 아직 없다.
자주 묻는 질문
GitBot은 Claude Code, Codex, OpenCode에 재사용할 수 있는 일과 저장소 폴더, 다시 돌아갈 대화를 붙여 주는 로컬 서버다. npm으로 설치하고 브라우저 탭에서 작업한다.
관련 콘텐츠
GitBot와 관련된 도구, 스킬, 아티클을 살펴보세요.
GitBot 대안
Base Code
Base44 (Wix) · 코딩 · 생산성Base Code는 Base44가 만든 공유 클라우드 개발 환경이다. 팀은 기존 GitHub 저장소에 대한 변경을 채팅으로 설명하고, 미리보기로 확인한 뒤 풀 리퀘스트로 돌려보낸다.
Google EmbeddingGemma 2
Google DeepMind · 글쓰기 · 이미지 · 코딩Google EmbeddingGemma 2는 7억 4000만 파라미터의 오픈 모델로, 텍스트와 코드, 이미지, 오디오, 영상 프레임을 하나의 768차원 공간에 벡터로 바꿔 스마트폰과 노트북에서 실행한다.
GitGlow
GitGlow · 코딩 · 생산성GitGlow는 내 코드와 AI 에이전트의 변경을 한 리뷰에 모으는 데스크톱 Git 클라이언트다. 배포 전에 내 기계에서 무엇이 나가는지 확인할 수 있다.