najmuzzaman-mohammad/gawkbot

gawkbot – 오픈소스 “항상 켜져 있는” AI 어시스턴트를 내 기기에서

이것이 무엇인가 – gawkbot은 데스크톱(macOS) 및 iPhone 동반 앱으로, 워크플로우에 대한 자연어 설명을 전용 AI 기반 “마이크로 앱”으로 전환합니다. 각 마이크로 앱(봇이라고 함)은 로컬에서 실행되며, 이미 보유한 LLM(Claude Code, Codex, Opencode, 또는 Ollama/Hermes/OpenClaw를 통해 노출하는 모든 로컬 모델)을 사용하고, 1,200개 이상의 통합(Slack, Gmail, HubSpot 등)에 대해 작업할 수 있습니다. 모든 외부 작업(보내기, 커밋, 구매, 삭제)은 사용자의 클릭을 요구하는 승인 게이트 뒤에 일시 중지됩니다.

작동 방식

• 에이전트 감지 – 시작 시 gawkbot은 PATH, 구성 폴더 및 실행 중인 프로세스를 스캔하여 기존 LLM-CLI 도구(Claude Code, Codex, Cursor 등)를 발견합니다. 감지된 에이전트는 채택되어 개별 봇이 될 수 있습니다.
• 봇 구축 – 한 문장으로 워크플로우를 설명(또는 데모)합니다. 선택한 LLM이 봇을 구축합니다: 샌드박스 디렉토리, 화면 UI, 일정(루틴), 도구 세트, 타입이 지정된 데이터 테이블, 인용이 포함된 지식 위키 페이지.
• 런타임 – 각 봇은 내 기기(또는 지정한 클라우드 VM)의 자체 샌드박스에서 실행됩니다. 사이드카 서비스(agent/)가 봇 프로세스를 감독합니다. 봇은 iPhone 앱에서도 접근할 수 있으며, 동일한 질문 받은 편지함을 표시합니다.
• 노치 UI – macOS에서 어시스턴트는 카메라 노치에 있습니다. 무드, 사운드 큐, 키보드 단축키(⌃⌥Space로 열기, J/K로 탐색, 1-9로 답변 선택, V로 말하기 등)로 팝업됩니다.
• 승인 게이트 – 읽기는 자유롭습니다. 모든 쓰기 작업은 ExternalActionApprovalCard로 표시되며 봇이 진행하기 전에 수동 승인을 기다립니다.
• 공유 – 비공개 Tailscale/WireGuard 메시(gawkbot share) 또는 일회용 URL을 생성하는 공개 Cloudflare 터널을 통해 팀원을 초대할 수 있습니다.
• 영속성 – 봇 상태, 대화 기록 및 “회사 두뇌”는 ~/.wuphf/ 아래에 일반 파일로 저장되므로 검사하거나 삭제할 수 있습니다(gawkbot shred).

주요 기능

기능	제공 내용
앱 UI	봇의 작업 공간, 도구, 데이터 테이블 및 지식 페이지를 보여주는 실제 화면.
루틴	Cron 유사 일정, 버전 관리된 프롬프트, 실행별 대화 기록.
도구	봇에게 가르치는 사용자 지정 작업(예: “리드 점수 매기기”).
지식	모든 주장에 인라인 인용이 있는 위키 스타일 페이지.
통합	1,200개 이상의 사전 구축 커넥터; 한 번 연결하면 모든 봇이 공유합니다.
승인 게이트	모든 외부 쓰기에는 클릭이 필요합니다. 비용, 토큰 및 실행 횟수를 볼 수 있습니다.
다중 작업 공간	나열, 전환 또는 공유할 수 있는 격리된 작업 공간.
로컬 우선	내 하드웨어에서 실행되고 내 API 키를 사용합니다. 선택적 텔레메트리는 기본적으로 꺼져 있습니다.

시작하기

1. gawk.bot/download.html 또는 GitHub 릴리스에서 macOS 앱을 설치합니다.
2. 첫 실행 시 런타임을 확인하고 LLM CLI에 로그인합니다(Claude Code가 기본값).
3. 첫 워크플로우를 설명하고 실시간 빌드 피드를 확인합니다.
4. 노치 또는 iPhone 앱(apps/ios)을 통해 상호 작용합니다.

소스에서 설치 (Go 1.25+ 및 웹 UI용 Bun 필요):

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

구성 플래그 – 예: --provider ollama로 로컬 Ollama 모델 사용, --no-open으로 브라우저 자동 열기 억제, --unsafe로 개발 전용 권한 우회.

개인정보 보호 – 선택적 익명 분석 및 세션 녹화는 PostHog 키를 설정하지 않는 한 비활성화됩니다. 모든 데이터는 로컬에 저장됩니다. 봇 환경에는 키가 저장되지 않습니다.

중요한 이유 – gawkbot은 상용 서비스(예: xAI의 Grok Bot)와 동일한 “항상 켜져 있는” 어시스턴트 경험을 제공하지만 자체 호스팅, 무료, 모든 작업에 명시적 인간 승인이 있습니다. 이는 사용자가 제어하는 모든 LLM으로 확장할 수 있는 개인 AI 에이전트 오케스트레이션의 구체적인 예입니다.