Skip to main content

What is the CLI?

Summer is the game engine built for AI. The summer CLI (npm package summer-engine) installs the engine, creates projects, runs the engine, and connects your AI agent (Claude Code, Codex, Cursor, Devin Desktop and many more) to Summer Engine. Your agent then starts the MCP server itself. You chat with the AI in your IDE, and the AI uses MCP tools to manipulate scenes, run the game, and debug. Use npx summer-engine (no install) or summer after you install it:
Want your agent to use Summer from its shell, with no MCP server? Install the skills only:
Then summer ops search "<words>" finds any operation, signed in or not, and summer <area> <action> runs it. See Operations from the shell.

Install the Engine

Downloads and installs Summer Engine, about 1 GB (macOS: /Applications/Summer.app; Windows: the default location; Linux x86_64: ~/.summer/engine/). It never replaces an installed engine without asking. No npm global install required.

Sign In

Opens your browser once. You sign in to your Summer account with Google, GitHub, or email, then approve the store, publishing and Grow tools in the same browser. If that second step does not finish, run summer login --store.

Create a Project

Creates a new project from a template in the current directory. empty (minimal 3D) and 3d-basic (camera, light, floor) are built in and work offline. summer list templates shows the pinned library templates too: platformers, FPS, racing, roguelikes, multiplayer starters and more.

Run the Engine

Launches Summer Engine with your project. Engine tools need the engine running with your project. Cloud operations (assets, plans, the store, prices, analytics) do not.

Connect Your Agent

One command writes the MCP config for your agent and installs the Summer skills:
The agent spawns summer mcp when it connects. You don’t run it manually. To edit the config by hand, add this to your agent’s MCP config:
See MCP setup for each agent. For cloud work only (assets, plans, the store, publishing), you can skip the install and add https://mcp.summerengine.com/mcp to your agent instead.

Run Summer Operations from the Shell

Every Summer operation runs from the shell, with the same answer as in the MCP:
Add --dry-run to check a change first, --wait to follow a job or an approval, and --json for the answer only. Exit code 0 means an ok answer, 1 an error. Details: Operations from the shell.

Full CLI Reference

Full CLI Reference

All commands with options, examples, and file locations

← MCP overview · MCP setup →