Grain / Docs / Install Grain

Docs

Install Grain

Download the free Mac app from rungrain.com, then use the CLI to sign in and create a workspace for the current folder. The app's download dialog asks for an early-access phrase and includes a request-access form.

Updated 2026-09-03By the Grain team

Mac app

Download the Mac app from rungrain.com. Grain is Mac first; Windows has a waitlist, and the self-hostable core runs on Linux.

Sign in

grain login

Use the login command before creating a workspace.

Create a workspace

grain init

The init command creates a workspace for the current folder and writes agent configuration to .mcp.json for Claude Code, .codex/config.toml for Codex and .cursor/mcp.json for Cursor. Pass --no-agent-config when you do not want those files written.

Check the install

grain doctor

grain doctor prints local CLI auth and workspace link status. Pass a path to check a different folder: grain doctor path/to/project.

Updating

The Mac app updates itself and refreshes the bundled CLI with each app update. There is no separate CLI update command. grain upgrade does something else: it promotes a pushed static workspace to an app runtime, and it is covered in the CLI reference.

Frequently asked questions

Is Grain available for Windows?

Grain is Mac first. The download flow offers a Windows waitlist, and the self-hostable core runs on Linux.

Which coding agents does Grain configure?

The init command writes configuration for Claude Code, Codex and Cursor. Any CLI agent that speaks MCP can work with Grain.

Can I skip agent configuration?

Yes. Pass --no-agent-config to the init command.

How do I update the Grain CLI?

Update the Mac app; it refreshes the bundled CLI. grain upgrade is not an updater: it promotes a static workspace to an app runtime.

Keep what your agent builds

Download the free Mac app and use the coding agent plan you already have.

Free forever. No card. Bring your own agent.

Sources · facts verified 2026-09-03