Skip to main content

​
What is the CLI?

The Summer Engine CLI lets you install the engine, create projects, run the engine, and connect your AI IDE (Claude Code, Cursor, Windsurf) to Summer Engine. Add the MCP config to your IDE and it will spawn the MCP server—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 global install).

​
Install the Engine

npx summer-engine install
Downloads and installs Summer Engine to your system (macOS: /Applications/Summer.app, Windows: default location). No npm global install required.

​
Sign In

npx summer-engine login
Opens your browser to sign in with Google, GitHub, or email. Saves your session for analytics and future cloud features.

​
Create a Project

npx summer-engine create 3d-basic my-game
Creates a new project from a template. Templates: empty (minimal 3D) or 3d-basic (camera, light, floor).

​
Run the Engine

npx summer-engine run my-game
Launches Summer Engine with your project. The engine must be running for MCP tools to work.

​
Start MCP (for Cursor, Claude Code, Windsurf)

Add this to your IDE’s MCP config. The IDE spawns summer mcp when it connects—you don’t run it manually: 
{
  "mcpServers": {
    "summer-engine": {
      "command": "npx",
      "args": ["summer-engine", "mcp"]
    }
  }
}
See MCP setup for IDE-specific instructions.

​
Full CLI Reference

CommandDescription
summer installDownload and install Summer Engine
summer loginSign in via browser
summer logoutClear auth tokens
summer statusCheck engine status, port, auth
summer run [path]Launch engine, optionally with project
summer open <path>Open project in running engine
summer create <template> [name]Create project from template
summer list templatesShow available templates
summer list projectsShow projects in current directory
summer skills listList available skills
summer skills install <name>Install a skill to ~/.summer/skills/
summer mcpStart MCP server (used by IDEs)

Full CLI Reference

All commands with options, examples, and file locations
← MCP overview · MCP setup →