Locum

Let Grok Bot hand coding work to the Claude Code and Codex CLIs on your own machine

About

Grok Bot as the manager, your local CLI as the coder

Grok Bot runs in xAI's cloud and cannot see localhost, so Locum runs on your machine and exposes an MCP endpoint over a Cloudflare tunnel, with its own tiny OAuth server and a passphrase gate on the consent screen. The bot gets delegate_to_claude, delegate_to_codex, resume_claude, resume_codex, check_job, list_jobs, cancel_job and status. Jobs are async: a delegation returns a job id right away, the bot polls every 30 seconds or a completion webhook wakes one of its routines when the job ends, and follow-ups resume the same session to reuse the prompt cache. A local dashboard shows every session with its prompt, transcript, tokens and cost. Spend caps (LOCUM_MAX_COST_USD and LOCUM_MAX_JOBS_PER_DAY, over a trailing 24 hours) refuse new jobs once tripped. Delegated jobs run unattended with full permissions starting from the folders you allow, so keep LOCUM_ROOTS narrow and use it only for your own work on your own subscriptions (the README spells out the Anthropic terms). Your machine has to stay awake with the tunnel up, and it cuts bot usage rather than zeroing it. Made by Harjot Singh (@harjjotsinghh).

Features

Custom Grok connector over a Cloudflare tunnel, with OAuth and a passphrase gate
Delegates to the official claude and codex binaries, never touches tokens
Async jobs with resume, cancel and an optional completion webhook
Spend caps per trailing 24 hours, in dollars and in jobs
Dashboard with prompt, transcript, tokens and cost per session
Doctor command that checks token, roots, CLIs and port

Install