gawkbot
najmuzzaman-mohammad/gawkbot
Local bots that build microapps for your workflows and run on Claude Code, Codex, Hermes or OpenClaw
gawkbot is a self-hosted bot platform that turns a one-sentence workflow description into microapps with their own schedule, tools and approval gate. The README lists Hermes among the models and agents it can run on.
What gawkbot does
gawkbot turns a one-sentence description of a manual workflow into a microapp: a bot with its own screen, schedule and tools, with a human approval gate on everything it sends. It claims 1200+ integrations and runs locally on your machine and account. If Claude Code, Codex or Opencode are already running, gawkbot finds and adopts them under a Chief of Staff, and a small notch pop-up on a Mac, or an iPhone app, asks you when an agent needs input.
The README compares it with xAI's Grok Bot and lists the models and agents it can use: Claude Code, Codex, Opencode, local models, Hermes, OpenClaw and any agent CLI found on the machine. Each bot gets a sandbox on your machine or a cloud computer, with its own directory and tool allowlist, and every send, commit, purchase and delete waits for a click. A signed Mac .dmg is available, and the project can be built from source with Go and Bun.
Key features
- Builds a microapp bot from a one-sentence workflow description
- Human approval gate on every send, commit, purchase and delete
- Per-bot sandbox with its own directory and tool allowlist
- Adopts agents already running on the machine, including Claude Code, Codex and Opencode
- Mac notch pop-ups and an iPhone companion app for approvals
- Runs locally with your own keys
When to use it
- Automate a recurring manual task and review its output in a small dedicated screen
- Manage several coding agents from one Chief of Staff
- Answer an agent's approval request from your iPhone
Who it is for: Individuals who want local, approval-gated bots that automate routine work on top of the agents they already use.
How it fits with Hermes Agent
The README lists Hermes among the models and agents gawkbot can use, next to Claude Code, Codex, Opencode and OpenClaw.
How to install gawkbot
These commands are copied from the project's README. Check the repository for the latest steps before you run them.
git clone https://github.com/najmuzzaman-mohammad/gawkbot.git
cd gawkbot
cd web && bun install && bun run build && cd ..
go build -o gawkbot ./cmd/wuphfRequirements: One signed-in bot CLI (Claude Code by default, or Codex CLI or Opencode); Go and Bun to build from source; macOS for the app download
Note: The source is public under the Sustainable Use License rather than a standard open-source license.
FAQ
What is gawkbot?
gawkbot is a self-hosted platform that builds bots as microapps from a short description of a workflow. Each bot has its own screen, schedule and tools, and actions that leave your machine wait for your approval.
Does gawkbot work with Hermes Agent?
The README lists Hermes among the models and agents gawkbot can use, alongside Claude Code, Codex, Opencode and OpenClaw. The excerpt reviewed does not give Hermes-specific setup steps.
Is gawkbot free and open source?
The README says it is free and that the source is public under the Sustainable Use License. GitHub does not detect a standard license, so read the LICENSE file before reusing the code.
Similar automations for Hermes Agent
All automationsCLI that converts Markdown to WeChat Official Account articles and creates drafts for AI agents
XiaoMi Xiaomi MilocoXiaomi's open-source whole-home AI that perceives through Mi Home cameras and orchestrates devices
AtomicBot-ai Atomic AgentLocal-first AI agent that runs open-weight models through llama.cpp and imports Hermes sessions
hanliang97 MatrixMediaElectron and CLI tool for batch video publishing to Chinese platforms, callable by agents
indranilbanerjee Digital Marketing ProOpen-source AI marketing plugin with 164 skills and 24 agents that installs on Hermes Agent and others
unifapi-agent UnifAPI AgentsRead-only marketing agents as SKILL.md skills: SEO audits, AI visibility, local SEO and KOL pricing
Related guides: Build agent teams with the Hermes kanban board · How to run Hermes Agent securely