Grok Build

Grok Build can use Mirage through either an installable TypeScript plugin or a FUSE mount. The Python integration FUSE-mounts a workspace as a normal host directory, so Grok’s built-in filesystem and shell tools operate on Mirage without a separate tool server.

Install

uv add 'mirage-ai[fuse]'

Install Grok Build separately.

Usage

from mirage import Mount, MountMode, Workspace
from mirage.resource.ram import RAMResource

with Workspace(
    {"/": Mount(RAMResource(), mode=MountMode.WRITE, fuse=True)}) as ws:
    print(f"cd {ws.fuse_mountpoint} && grok")
    input("Press Enter when done...")

The mountpoint behaves like a regular directory. Start grok there and its built-in file and shell tools dispatch through Mirage’s ops layer.

FUSE or plugin?

Use Python FUSE when you want Grok’s built-in tools to see Mirage as an ordinary directory. This requires an OS FUSE driver and does not add Mirage’s agent-level stale-write check. Use the TypeScript plugin when you want named Mirage tools, Pi-style stale-write protection, and Grok plugin installation. The plugin uses Mirage’s standard MCP adapter internally.

Getting Started

Agents

Resources

Runtimes

Install

Usage

FUSE or plugin?

​Install

​Usage

​FUSE or plugin?

Install

Usage

FUSE or plugin?