What is safe-grokbot-bridge?
safe-grokbot-bridge is a daemon that connects a remote AI agent, such as Grok Bot, to selected folders and coding-agent sessions on a Linux, macOS or Windows machine. Through an authenticated HTTP API, a remote agent can inspect project files and Git history, work with Claude Code, Codex CLI or Hermes sessions, and use models configured on the machine. It is aimed at developers who want a remote agent to coordinate local work, including when they are away from the keyboard, while choosing which capabilities and folders to expose.
safe-grokbot-bridge Features:
Agent Sessions: The API can list, start, message and stop Claude Code, Codex CLI and Hermes Agent sessions, as well as other terminal programs running in tmux.
Session Modes: Coding agents can run in tmux terminals that remain available to attach to, or in headless runs that continue a conversation using the agent's session ID.
Model Access: Configured local or paid models can provide chat, vision, embeddings, reranking, speech-to-text, text-to-speech and image capabilities through OpenAI or Anthropic client libraries.
Project Access: The bridge can list allowed directories, read text files by line range, and return Git status, log, diff and show output; file access excludes items such as .env files and private keys.
File Transfer: Clients can upload files into a workspace inbox under generated names that do not replace existing files, and download files up to 96 MB each way.
Access Controls: Bearer-token authentication, per-IP lockout, per-token rate limits, audit logging and folder-specific capabilities govern API requests, with no generic shell endpoint.
Tunnel Setup: The bridge listens on localhost and can be reached through an outbound Cloudflare Tunnel; public addresses require TLS, with self-signed certificates and key pinning supported.
safe-grokbot-bridge Benefits:
Work Away: A remote agent can keep a coding task moving and check on local sessions while the developer is away from the workstation.
Keep Context: Remote coordination can build on existing Claude Code, Codex or Hermes conversations instead of requiring every task to start from scratch.
Choose Exposure: Per-folder capabilities let the owner grant only the file, Git or session access a particular job needs.
Protect Credentials: Model API keys remain on the machine, and file endpoints exclude common sensitive files such as environment files and private keys.
Review Activity: An audit log of requests gives the owner a record of activity through the bridge.
Use Cases:
Remote Code Fixes: Ask a remote agent to start a coding session in a project, investigate a problem and follow up on its response.
Test Follow-Up: Have a remote agent run tests through a local coding agent, then review the session's status and answer follow-up prompts.
Project Review: Let an agent inspect selected project files and Git history when preparing a change review or checking recent work.
Task Handoffs: Leave tasks in the machine's inbox for Grok Bot to retrieve when its owner asks it to handle them.
Local Model Calls: Route a compatible program through the bridge to configured local vLLM models or paid model APIs.

