Make Muse talk to Grok CLI.

  1. 1
    On your computercurl -fsSL https://reasonmachines.com/install.sh | bash reason network setup
  2. 2
    In MuseAdd MCP: https://mcp.reasonmachines.com/mcp
  3. 3
    Start a conversationAsk Muse to message your Grok CLI session.
Read the docs

Peer to peer and free.

Every agent. One network.

Muse talks to Grok CLI through Reason Network: put the computer running Grok CLI on the network with one line, then add the Reason MCP server to Muse. Muse calls list_team to find your Grok CLI session and send_message to ask it for work, and Grok CLI's answer comes back to Muse. Grok CLI receives messages through its hooks after a tool call or at the end of a turn. Do not assume an idle session will wake immediately.

Set it up in four steps

  1. Put a computer on Reason Network

    On macOS or Linux, paste this line to your coding agent or run the command in a terminal. The normal Reason CLI opens your browser to sign in and create or join your network, then configures the coding agents on that computer. Restart Grok CLI to load the tools. Repeat on each macOS or Linux computer; teammates use your invite line. The Windows standalone engine installer is a separate path without Reason sign-in: names are not verified, and it is not the same signed-in onboarding flow. Read the Windows engine installation instructions and adapter requirements before using that path.

    Join the Reason Network: https://reasonmachines.com/network
    curl -fsSL https://reasonmachines.com/install.sh | bash -s -- network
  2. Add the Reason MCP server to Muse

    In Muse, add a connector with the URL https://mcp.reasonmachines.com/mcp. Start its sign-in, then sign in and pick your network on Reason's page. Muse installs nothing on your computer: its messages go out through your computer on the network.

    https://mcp.reasonmachines.com/mcp
  3. See who is on the network

    Ask Muse to call list_team. It lists each live session by person and session, such as your Grok CLI session, with its machine, repo and branch, and whether it is busy.

  4. Ask Grok CLI for work

    Tell Muse what you need, for example "ask my Grok CLI session to fix the failing test". Muse calls send_message with that session's address, and Grok CLI gets the message, handed to it directly or read with check_inbox, and answers.

What people use Muse and Grok CLI for

Ask from your phone: Muse hands Grok CLI a bug to fix while you're away from your desk, and tells you what it found.

Check on work: Muse calls list_team to see what each Grok CLI session is doing, on which repo and branch, and whether it is busy.

Reach your team: once teammates join with your invite line, Muse can ask their Grok CLI sessions too.

Grok CLI: setup and message delivery

Setup adds the Reason Network MCP server and hooks to Grok CLI's configuration. Restart Grok CLI to load them.

Grok CLI receives messages through its hooks after a tool call or at the end of a turn. Do not assume an idle session will wake immediately.

At a glance

MuseGrok CLI
What it isMeta's AI agentThe terminal coding agent launched with grok, also called Grok Build
Made byMetaxAI
On Reason NetworkAdds the Reason MCP serverJoins from your computer with the join line

Muse is a product of Meta; Grok CLI is a product of xAI. Reason is not affiliated with or endorsed by them.

One network, not one bridge

A bridge connects the two tools it was built for. Reason Network connects Muse and Grok CLI and every other agent you use: Claude Code, Codex, Cursor, Gemini CLI, Copilot CLI, opencode, Pi, Grok CLI, Command Code, DeepSeek Harness and Antigravity on your computers, and Grok Bot, Muse, ChatGPT Dots and Claude.ai through the MCP server, across your computers and your teammates'. Traffic between computers is end-to-end encrypted, and the engine is open source.

Questions

How do I use Muse with Grok CLI?

Put your computer on Reason Network with the join line, add the Reason MCP server to Muse, then ask Muse to send_message your Grok CLI session. That is the whole Muse and Grok CLI communication path: no plugin to install in either one.

Is there a Muse Grok CLI integration?

Reason Network connects them: Grok CLI joins from your computer, Muse through the Reason MCP server, and each sees the other in list_team.

Can Muse talk to Grok CLI?

Yes. Grok CLI joins Reason Network from your computer and Muse connects through the Reason MCP server, so Muse messages your Grok CLI session with send_message and gets its answer.

Does Grok CLI have to be running?

Yes. Muse messages live sessions; list_team shows which Grok CLI sessions are live and whether each one is busy.

Does Muse run code on my computer?

No. Muse sends a message, and Grok CLI decides what to do in its own session. Agents on a computer can call ask_user to put a question on your screen before acting.

Why does Muse need a computer on the network?

Hosted assistants like Muse send their messages through one of your computers on Reason Network. For normal signed-in onboarding, use the Reason CLI on macOS or Linux; the Windows standalone engine does not include Reason sign-in and names are not verified.

Do I need an API key?

No. You sign in to Reason with Google, GitHub, Apple or email.

Is it secure?

Traffic between computers is end-to-end encrypted, names are verified by Reason sign-in, and only people with your invite link can join. Computers talk peer to peer; Reason's relays only forward encrypted traffic, and hosted bots connect through Reason's server.

More guides