Repolode
Submit
robbin

robbin/grokbot-local-agent

Scripts that let Grok Bot hand heavy coding and writing tasks to a local Pi agent on the same machine and get woken by webhook when they finish.

View on GitHub
Stars
86
Forks
11
Open issues
0
Last commit
12 days ago

What is it?

grokbot-local-agent is a set of scripts for delegating work from a Grok Bot to Pi, a local coding agent, on the same Linux machine. Heavy jobs such as batch file edits, small scripts, long drafts and research run through Pi using the user's own model account, which keeps them off the Bot's subscription allowance.

Each delegated call is wrapped in a tracked task stored under ~/.pi/tasks/<ID>/, with status and artifacts on disk. When a task completes, a webhook receives only its ID, owner, state and exit code, which wakes the Bot to read the files, verify the outcome, report it and acknowledge the task. Owner-filtered pending, list and ack commands keep multiple Bots from reporting each other's work, and pending lets the Bot recover outcomes after a missed notification.

The project is a lightweight helper for the Bot's own machine rather than an isolated sandbox service. It requires Node 22+ and has no third-party dependencies for its client script.

Key features

  • 01Runs delegated work through the Pi coding agent on the same machine.
  • 02Tracks each task with an ID, status and artifacts on disk.
  • 03Sends a webhook on completion so the Bot can verify and report results.
  • 04Filters pending, list and ack by owner agent ID to avoid cross-Bot reporting.
  • 05Supports follow-up turns, cancellation and a fixed-model synchronous shortcut.
  • 06Optional Telegram monitor pushes Pi session progress to a private chat.

Use cases

  • Offloading batch file edits or small scripts from a subscription-limited chat bot.
  • Running long document drafts or research while the Bot's conversation turn has ended.
  • Getting a verified report from a background coding task via webhook wakeup.
  • Following delegated agent sessions live from a phone through Telegram.

Quick start

  1. 1

    Install Node 22+ and the Pi coding agent

    npm i -g --prefix ~/.local @earendil-works/pi-coding-agent
  2. 2

    Log in to the model yourself by running pi interactively and entering /login

  3. 3

    Copy the scripts into ~/tools/pi-call

    mkdir -p ~/tools/pi-call && cp -a bin/. ~/tools/pi-call/
  4. 4

    Run a smoke test that should print OK

    ~/tools/pi-call/pi-run /tmp "Reply with only OK" --timeout 120

Things to know

  • Requires Node 22+ and a separate model account or subscription that you must authenticate yourself.
  • Needs a webhook routine and secret configuration on the Grok Bot host, which adds setup effort.
  • It is a lightweight helper, not an isolated sandbox, and does not provide strong permission isolation.

In collections

Open-source AI agent frameworks & appsAI coding assistants & agents

Topics

#ai-agent#local-agent#webhook#automation#task-queue#coding-agent#telegram

FAQ

What is grokbot-local-agent?
Scripts that let Grok Bot hand heavy coding and writing tasks to a local Pi agent on the same machine and get woken by webhook when they finish. grokbot-local-agent is a set of scripts for delegating work from a Grok Bot to Pi, a local coding agent, on the same Linux machine. Heavy jobs such as batch file edits, small scripts, long drafts and research run through Pi using the user's own model account, which keeps them off the Bot's subscription allowance.
Is grokbot-local-agent free to use? What license does it have?
grokbot-local-agent is open source under the MIT license. Check the license terms before using it in commercial products.
Is grokbot-local-agent still maintained?
Actively maintained. The last commit to grokbot-local-agent was on Oct 26, 2026.
What can I use grokbot-local-agent for?
Offloading batch file edits or small scripts from a subscription-limited chat bot. Running long document drafts or research while the Bot's conversation turn has ended. Getting a verified report from a background coding task via webhook wakeup. Following delegated agent sessions live from a phone through Telegram.
How do I install grokbot-local-agent?
Install Node 22+ and the Pi coding agent: npm i -g --prefix ~/.local @earendil-works/pi-coding-agent Log in to the model yourself by running pi interactively and entering /login Copy the scripts into ~/tools/pi-call: mkdir -p ~/tools/pi-call && cp -a bin/. ~/tools/pi-call/ Run a smoke test that should print OK: ~/tools/pi-call/pi-run /tmp "Reply with only OK" --timeout 120
Where can I get grokbot-local-agent?
The source code and installation instructions are on GitHub: https://github.com/robbin/grokbot-local-agent

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects