Docs

Grain documentation

Use the Grain Mac app and CLI to create workspaces for agent-built artifacts. Start with installation, then publish the first useful result.

Install Grain

Download the Grain Mac app, sign in from the CLI, create a workspace, write agent configuration and check the installation.

Create a Grain workspace, publish files, save a checkpoint and get a public or password-protected share URL.

Understand the Grain model: artifacts are what agents make, workspaces keep them, and sandboxes provide compute when code needs to run.

Reference every Grain CLI command, positional argument and documented flag, with expected output and common failure messages.

Connect a coding agent to Grain over stdio, understand the generated config files and use each workspace MCP tool safely.

Understand where Grain artifact files live, how local and hosted workspaces differ, what each sharing mode exposes and how export works.

Diagnose Grain authentication, workspace links, remote drift, static-runtime errors, desktop handoff and continuous sync failures.