summer-cli is a skill from the Summer skill library: a guide your AI agent reads when the task matches, so it builds the good version on the first try. Summer as shell commands, no MCP: sign in, run operations, follow jobs, save files, drive the engine.
When your agent uses it
- The session has no summer_* MCP tools, or Summer was set up with summer setup <agent> —cli
- Running a Summer operation, a generation or an engine change from a shell, a script or CI
- A skill names an MCP tool or an operation and you need the summer command that runs it
- Starting Summer Engine or reconnecting to an existing project
Install
summer setup installs every skill for your agent. To add only this one:
claude-code for your agent, such as codex or cursor. See Skills for every option.
The skill
Use this skill when the session has nosummer_* MCP tools (including after setup, before the host loads them), when Summer Engine needs starting, or when a script or CI job runs Summer. Every Summer capability is an operation named area.action, and every operation is one command: summer <area> <action>. The commands run the same code as the MCP tools and give the same answers. Missing MCP tools do not mean the engine is stopped: continue through the Summer CLI in this session.
First run summer --version. If the shell does not find summer, or the version is below 4.0 (an old global install, which has no summer <area> <action> commands), put npx -y summer-engine@latest in place of summer, with the same arguments. In Windows PowerShell, write npx.cmd.
The five commands in a game project
summer run .opens the project in Summer Engine when run from its root (the folder containingproject.godot). An agent’s run stays in the background. If the engine is not installed, usesummer dev .; installation needs the person’s consent before adding--yes. Baresummer runfails: always give the project path.summer engine get-project-context(MCP:summer_get_project_context) verifies the connected project, its main scene and the engine version. Run it before editing; a launch command exiting successfully does not by itself prove the editor is ready.summer engine play, thensummer engine get-diagnostics(MCP:summer_play,summer_get_diagnostics), runs the game and reads its errors.summer engine stop(summer_stop) ends it.summer engine screenshot(MCP:summer_screenshot) saves an image of the editor or the running game. Open itslocalPathto look.summer ops search "<what you want>"(MCP:summer_search) finds any other operation. Run it assummer <area> <action>(MCP:summer_call), with--dry-runfirst for a change.
Start or reconnect to Summer Engine
Use this sequence for both MCP and CLI sessions. Engine commands need no sign-in.- Select the project. Find its
project.godotand run commands from that folder. For a new game, follownew-project:summer dev 3d-basic my-gamecreates and opens a starter. For an existing game, keep its exact path; do not create a replacement project to recover a connection. - Open it yourself when shell access is available. Run
summer run .from the project root, orsummer run "<project-path>". This opens an installed Summer Engine; it does not install one.summer run --no-projectopens the project manager without a project and is not a recovery step for working on a game. - Handle a missing installation.
summer dev "<project-path>"opens an existing project and can install Summer Engine if needed. Without consent, a non-interactive call returnsneeds_confirmationand installs nothing. Ask the person once, then repeat the same command with--yesonly after they agree. Keep any explicit--bin/SUMMER_BINselection: an invalid override must be corrected, not silently replaced. Do not substitute a stock Godot executable for Summer Engine. - Wait for readiness.
summer runwaits up to 20 seconds for the local API; it can exit successfully with an “API not responding yet” message.summer devwaits up to 180 seconds and exits with an error if the editor is still opening. Neither message means that another editor should be launched. Follow the output, usesummer status, and retry the project-context read after 30 seconds if assets are still importing. If it still fails, runsummer doctorand report the specific blocker instead of repeatedly launching or reinstalling. - Verify before changing anything. Run
summer engine get-project-context(orsummer_get_project_contextover MCP) and confirm that the project and engine version are the intended ones. If multiple editors are open, setSUMMER_ENGINE_PROJECTto that project’s folder for the shell commands. Then continue the requested work through whichever transport is available; missing MCP tools alone do not require a restart to use the CLI.
projects.open_local if the session exposes it (install: true only with installation consent), then read project context. If neither transport is available, report that limitation and give the person the exact launch command for their project. Starting the editor cannot make an absent MCP tool appear in the host’s tool list.
1. Sign in once
summer login in the foreground, once. Tell the person that their browser opens, and wait for them.
2. Find the operation
--area assets keeps one area. Without a sign-in, search and describe still find every operation: a cloud one shows (needs sign-in) and runs after summer login.
For a guide instead of an operation, search the library: summer docs search --query "<the task>", then summer docs read --id <id>. Both work offline. Then follow the skill it names.
Each Summer skill ends with a From a shell table: the command for each MCP tool and operation the skill names. A skill that says summer_play or assets.generate_image means summer engine play or summer assets generate-image.
3. Run it
- Actions and fields are kebab-case:
aspectRatiois--aspect-ratio,look_atis--look-at. --<field>alone sets a boolean field to true;--no-<field>sets it to false. Repeat a flag to give a list.- Objects, and anything hard to quote, go in
--input '<json>'. A flag wins over the same key in--input. --dry-runchecks the input and changes nothing. For a spend it shows the estimate in credits. Put it right after the action: aftersummer setup <agent> --cli --allow-rules --yes(run that only when the person asks for it), Claude Code and Codex run it without asking (and the reads). Before each generation or other spend: dry-run it, tell the person what you will make, and wait for a yes.--idempotency-key <key>makes a retry safe: Summer runs a change once per key.--jsonprints only the answer:{"ok":true,"status":"done","result":{...}}. The exit code is 0 for everyokanswer and 1 for an error.
4. Long jobs
3D, video, animation, builds and uploads answerStarted: job <id> with the command that follows the job.
5. Approvals
A publish or another live change can answerNeeds approval with a link. Give the person that link: nothing changes until they approve. Follow it with summer jobs wait --job-id <id> (or --wait on the call) until it ends: done, declined, expired or stale. Never approve for the person.
6. Files
--out <folder or file>on a generate command, onsummer jobs waitor onsummer assets getsaves the file there. In a Godot project,res://paths work. The answer addslocalPath.- Without
--out, a generation run inside a game project saves into its asset folder: Godotassets/, UnityAssets/Summer, UnrealContent/Summer, three.jspublic/assets. Outside a project, give--out. summer assets get --asset-id <id>saves only with--out.- A save never overwrites a file. Tell the person the
localPath.
7. The engine
Engine commands (summer engine …) drive the Summer Engine app on this machine. The app must run with the project open.
- Values are engine value strings, not JSON:
"Vector3(0, 10, 0)","Color(1, 0.5, 0, 1)". A resource is its class name:"BoxMesh". - Name the scene in every change:
--scene-path res://<scene>.tscn. - 3 or more scene edits are one script, not a chain of commands. Write a
func run(ctx):that ends withctx.save_scene()to a file, then runsummer engine run-script --scene-path res://main.tscn --source "$(cat build.gd)". Thescene-scriptingskill has the script API. - With more than one editor open, set
SUMMER_ENGINE_PROJECTto the project folder so the command picks the right one. - To watch the game in your own browser (Claude Code Desktop’s Browser pane, the Codex app’s in-app browser), run
summer previewin the background, from the folder the session started in. It serves http://127.0.0.1:5199 (the next free port if that one is taken; it prints the URL): the running game, or the editor view when no game runs, with a status line that says what to do next. It also adds asummer-previewentry to.claude/launch.jsonthere, so Desktop starts it and checks the game after each edit. A game frame comes about every 20 s, because reading one stalls the game; the page’s Refresh button takes one now. Keys and clicks on the frame go to the running game.--no-launch-jsonleaves the file alone. summer tool <slug> --args '<json>'runs an engine tool by its 3.x name too.summer tool --listlists them.
Without Summer Engine
Everything except section 7 works without the app: the sign-in, the library, generation, assets and files, the store and analytics. Skip thesummer engine … commands; there they answer engine_not_running. For assets for another engine or a web app, follow the summer-assets skill and stop at the file.
8. Errors
An error printsError (<code>): <message> and one Next: step, and exits 1. Do the next step. Retry only when the table says so.
Done means
- You ran each command and read its answer. Do not report an answer you did not get.
- Every spend had a dry run and a yes from the person first.
- Every file you made is saved, and you told the person its
localPath.
Related skills
using-summer: Session bootstrap: how to find and use Summer skills and the summer-engine MCP before any response.summer-assets: Game assets for any engine, no Summer Engine: find, generate and download them.scene-scripting: Build scenes, levels, HUDs and wiring with one editor GDScript (summer_run_script) instead of call chains.
Source:
library/skills/summer-cli/SKILL.md, rendered from summer-engine@4.9.2 on npm.
