gawkbot: 내 PC의 에이전트를 모아 승인 게이트로 관리하는 오픈소스 봇

Who Should Read

Claude Code·Codex를 여러 개 돌리며 에이전트별 승인과 비용 관리가 번거로운 개발자

Core Mechanics

• 글 제목과 README 내용이 다르다
  • 제목은 Karpathy식 LLM 위키(Markdown·Git)다.
  • 실제 README는 gawkbot이라는 에이전트 관리 도구 소개다.
  • 위키 유지 방식에 대한 설명은 원문에 없다.
• 한 문장 설명으로 봇을 만든다
  • 작업을 한 문장으로 쓰거나 한 번 시연하면 AI가 봇을 만든다고 한다.
  • 봇마다 화면, 스케줄, 도구를 따로 갖는다.
• 외부 쓰기는 전부 사람 승인을 거친다
  • 읽기는 자유롭고, 메일·Slack·CRM 쓰기와 커밋·구매·삭제는 승인 전까지 보류된다.
  • 승인하면 24시간 돌아간다.
• PC에 있는 에이전트를 찾아 봇으로 쓴다
  • PATH, 설정 폴더, 프로세스 목록을 보고 Claude Code, Codex, Opencode, Ollama 등을 찾는다.
  • 찾는 과정에서 아무것도 실행하지 않는다고 한다.
  • 채택한 에이전트는 자기 로그인으로 돌며 gawkbot의 키는 환경에서 빠진다.
• 메모리는 로컬 파일이다
  • ~/.wuphf/ 아래에 봇 지식, 실행 기록, 회사 브레인이 파일로 저장된다.
  • 지식 페이지는 출처를 인용하며, 별도 백엔드나 API 키는 필요 없다.
• 비용과 현황을 README가 직접 밝힌다
  • 봇 하나 만드는 데 Claude Code 기준 보통 $1–2가 든다고 한다.
  • 기능마다 shipped, partial, planned 상태를 표로 적었다.
  • iPhone 앱은 작성됐지만 CI 빌드는 아직이라고 한다.

Community Reactions

• 제목과 저장소가 안 맞는다는 의견
  • 글 제목이 repo 내용과 전혀 맞지 않는다는 지적이 있었다.
  • Karpathy 위키 글이라 기대하면 다른 내용이 나온다.
• 에이전트가 쓴 기록이 썩는다는 우려
  • 사람이 안 본 채 에이전트가 쓴 항목은 6개월 뒤 자신 있게 틀린 내용이 되고, lint로도 못 거른다는 경험담이 있었다.
  • 에이전트가 스스로 승격할 수 있는지 묻는 질문도 있었다.
• LLM이 문서를 너무 많이 쓴다는 경험
  • 비슷한 도구를 만들어 봤더니 계속 문서화해서 커질수록 쓸모가 줄었다는 경험이 있었다.
• 길게 돌리지 말고 짧게 두 번 돌리라는 의견
  • 에이전트는 확률적이라 오래 돌수록 실패 확률이 올라간다는 의견이 있었다.
  • 10분 한 번보다 5분 두 번이 낫다는 주장이다.

How to Apply

• gawkbot을 소스에서 빌드해 첫 봇 만들기
  • Go와 Bun을 설치하고 아래 명령을 실행한다.
  • 로그인된 Claude Code가 있으면 http://localhost:7891 에서 온보딩을 진행한다.
• 우리 에이전트에 쓰기 승인 게이트 두기
  • 읽기는 통과시키고 메일·커밋·삭제 같은 쓰기 도구 호출만 사용자 확인 후 실행하게 만든다.
  • 승인 대상 목록을 먼저 적는다.
• 에이전트 메모리에 출처 인용 규칙 넣기
  • 에이전트가 쓰는 지식 항목마다 출처 링크를 필수 필드로 요구한다.
  • 출처가 없는 항목은 저장하지 않는다.
• 봇별 비용 보기 만들기
  • 봇마다 달러, 토큰, 실행 횟수를 기록해 한 화면에 보여 준다.
  • 봇 하나 만드는 비용을 기준선으로 잡는다.

Try It

# 터미널에 붙여넣기 (Go, Bun 필요 / README의 소스 빌드 절차)

git clone https://github.com/najmuzzaman-mohammad/gawkbot.git
cd gawkbot
cd web && bun install && bun run build && cd ..
go build -o gawkbot ./cmd/wuphf
./gawkbot --provider claude-code

# 브라우저에서 http://localhost:7891 이 열린다

Terminology

관련 논문

• 모델이 그렇게 좋다면 OpenAI는 왜 회사 100개를 직접 안 차릴까

  HN 댓글 답: 코드는 쉬워도 뭘 만들지 아는 건 별개라 토큰을 판다

• OpenShell: 자율 AI 에이전트를 가두는 NVIDIA의 안전한 샌드박스 런타임

  정책 파일로 에이전트의 파일·네트워크·자격증명 접근을 커널 수준에서 통제한다

• Omnara: Claude Managed Agents의 오픈소스 대안 (셀프호스팅 가능)

  어떤 모델·머신에서도 에이전트를 돌리는 오픈소스 managed agent 플랫폼

• Rust off Rails: 코드 없이 Markdown 60개로 만든 AI 에이전트용 웹 스택

  Markdown 규칙 60개로 에이전트가 Rust 웹앱을 짜게 한다는 프레임워크

• LayerFS: AI 코딩 에이전트를 위한 파일시스템

  에이전트마다 임시 Workspace를 마운트하고 결과만 커밋하는 파일시스템

• Launch HN: Alter (YC S25) – 멀티유저 에이전트용 접근 제어

  에이전트마다 별도 신원·정책·감사로 API 키 공유 문제를 푼다

• Claude로 코드의 공격 표면(attack surface) 줄이기

  Claude로 25개 오픈소스를 분석해 불필요하게 열린 코드 493건을 찾았다

• WhatsApp 도움말 페이지에 숨겨진 LLM 지시문: 규제기관을 추천하지 말라

  WhatsApp 도움말에 화면엔 안 보이는 AI 지시문 102개가 숨어 있었다

Related Resources

• https://github.com/nex-crm/wuphf
• https://github.com/najmuzzaman-mohammad/gawkbot
• https://x.com/karpathy/status/2039805659525644595
• https://gawk.bot
• https://github.com/GistNoesis/Shoggoth.db/
• https://manfre.me/posts/2026/04/build-llm-wiki-obsidian/