Skip to content

fix: Codex/Claude tools target user machines, not the Grok Bot box - #112

Merged
ScriptedAlchemy merged 3 commits into
mainfrom
cursor/codex-user-machine-not-box-9101
Sep 28, 2026
Merged

ScriptedAlchemy merged 3 commits into
mainfrom
cursor/codex-user-machine-not-box-9101

Conversation

@ScriptedAlchemy

@ScriptedAlchemy ScriptedAlchemy commented Sep 28, 2026 •

Copy link
Copy Markdown
Owner

Summary

Codex and Claude MCP/CLI tools use local Unix sockets only. gbot has no remote transport.

For Grok Bot agents on the box (HOME=/home/box): do not call codex_* / claude_send. Run the gbot CLI on the user's registered machine through Grok Bot Shell with a machineId, after codex app-server daemon start (or bootstrap) there.

Changes

  • Shared box/user-machine guidance used in absent-socket errors (Codex + Claude)
  • Box detection via HOME=/home/box (and /home/box/... paths)
  • Skill MCP instructions section, always-apply rule, tool descriptions, README
  • Plugin description notes local-socket / Shell-with-machineId rule
  • Tests for box detection and updated error text
  • Patch changeset for the next Changesets/OIDC publish

No remote transport was added.

Test plan

  • npm run check locally
  • PR CI green
Open in Web Open in Cursor 

When the Grok Bot sandbox has no local Codex socket, errors and plugin
docs now explain that sessions live on the user's registered computers
and how to target them via CODEX_APP_SERVER_SOCK or a local bridge.

Co-authored-by: Zack Jackson <ScriptedAlchemy@users.noreply.github.com>
@changeset-bot

changeset-bot Bot commented Sep 28, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 81a4981

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
grok-bot-cli Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

cursoragent and others added 2 commits September 28, 2026 18:46
gbot only dials a local Codex/Claude Unix socket. On HOME=/home/box, tell
agents not to call those tools — run gbot on the user's machine via Grok Bot
Shell with a machineId after daemon start/bootstrap. Drop SSH/remote guidance.

Co-authored-by: Zack Jackson <ScriptedAlchemy@users.noreply.github.com>
Co-authored-by: Zack Jackson <ScriptedAlchemy@users.noreply.github.com>
@ScriptedAlchemy
ScriptedAlchemy marked this pull request as ready for review September 28, 2026 18:51
@ScriptedAlchemy
ScriptedAlchemy merged commit 3508def into main Sep 28, 2026
2 checks passed
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 28, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-28T18:55:51.261626Z 81a4981 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 81a49818e6

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +7 to +9
"gbot connects only to a local Unix socket ($CODEX_HOME/app-server-control/app-server-control.sock, or CODEX_APP_SERVER_SOCK). There is no remote transport.",
"When running on the box (HOME=/home/box), do not call codex_* or claude_send there. Run the gbot CLI on the user's machine through Grok Bot Shell with a machineId (the host's machine-targeted shell).",
"On that machine, provide the socket with `codex app-server daemon start` (or bootstrap). Auth stays with each machine's native Codex or Claude login; gbot does not store or export credentials.",

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Show Claude’s actual channel setup in shared guidance

When sendToClaude finds no socket on /home/box, absentClaudeChannelMessage appends this block, which identifies only the Codex socket and tells the caller to start the Codex daemon. Claude actually uses ~/.grok-bot-cli/claude/<name>.sock, created by an opted-in Claude Code session launched with GROK_BOT_CLAUDE_CHANNEL; starting Codex cannot create it. An agent following this error therefore remains unable to use claude_send, so the guidance should provide separate Claude startup instructions.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants