Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
"url": "https://summerengine.com"
},
"homepage": "https://summerengine.com",
"repository": "https://github.com/SummerEngine/summer-engine-agent",
"repository": "https://github.com/summerengine/summer",
"license": "MIT",
"keywords": [
"game-dev",
Expand Down
2 changes: 1 addition & 1 deletion .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
"url": "https://summerengine.com"
},
"homepage": "https://summerengine.com",
"repository": "https://github.com/SummerEngine/summer-engine-agent",
"repository": "https://github.com/summerengine/summer",
"license": "MIT",
"keywords": [
"game-dev",
Expand Down
2 changes: 1 addition & 1 deletion .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
},
"publisher": "summer-engine",
"homepage": "https://summerengine.com",
"repository": "https://github.com/SummerEngine/summer-engine-agent",
"repository": "https://github.com/summerengine/summer",
"license": "MIT",
"category": "developer-tools",
"keywords": [
Expand Down
2 changes: 1 addition & 1 deletion .factory-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
"url": "https://summerengine.com"
},
"homepage": "https://summerengine.com",
"repository": "https://github.com/SummerEngine/summer-engine-agent",
"repository": "https://github.com/summerengine/summer",
"license": "MIT",
"keywords": [
"game-dev",
Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@

---

This repo is `summerengine/summer` — the front door to Summer. (It is being renamed from `SummerEngine/summer-engine-agent`; redirects keep every old link working.)
This repo is `summerengine/summer` — the front door to Summer. (It is being renamed from `summerengine/summer`; redirects keep every old link working.)

Your agent gets a real engine, not a chat box. With Summer installed, any AI coding agent can:

Expand All @@ -33,7 +33,7 @@ You stay in control of every change and release. Summer never publishes, install

Open your AI agent (Claude Code, Cursor, Codex, Copilot, Devin Desktop, etc.) and paste:

> Install Summer Engine and let's make a game. Read github.com/SummerEngine/summer-engine-agent, check what I already have installed, install whatever is missing, log me in, and scaffold a starter project so we can start building.
> Install Summer Engine and let's make a game. Read github.com/summerengine/summer, check what I already have installed, install whatever is missing, log me in, and scaffold a starter project so we can start building.

That's it. The agent reads this README, detects what's already on your machine, and runs only what's missing via Bash. **No `/plugin` slash commands. No manual installs. One paste.**

Expand Down Expand Up @@ -306,7 +306,7 @@ Not downloaded, not collected:

| Thing | License | Source |
|---|---|---|
| **Summer** (this repo: CLI, MCP server, library, integrations) | **MIT** | [SummerEngine/summer-engine-agent](https://github.com/SummerEngine/summer-engine-agent) |
| **Summer** (this repo: CLI, MCP server, library, integrations) | **MIT** | [summerengine/summer](https://github.com/summerengine/summer) |
| **Summer Engine app** (the desktop editor and runtime) | free to download, closed source for now | [summerengine.com/download](https://summerengine.com/download) |
| **Hosted Summer integrations** | availability and terms vary by rollout; preview features are labeled in the CLI | [summerengine.com/pricing](https://summerengine.com/pricing) |

Expand Down Expand Up @@ -376,4 +376,4 @@ Some process skills (brainstorming, writing-plans, writing-skills, investigating
- [Download Summer Engine](https://summerengine.com/download)
- [Documentation](https://summerengine.com/docs)
- [Community](https://summerengine.com/community)
- [Issues](https://github.com/SummerEngine/summer-engine-agent/issues)
- [Issues](https://github.com/summerengine/summer/issues)
4 changes: 2 additions & 2 deletions docs/DEVELOPMENT.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Summer: Development Guide

This repo (npm: `summer-engine`, GitHub: `summerengine/summer` — being renamed from `SummerEngine/summer-engine-agent`, redirects keep old links working) is **MIT, open source**. Treat all commits and code comments as public.
This repo (npm: `summer-engine`, GitHub: `summerengine/summer` — renamed from `summer-engine-agent` on 2026-09-10; GitHub redirects keep old links working) is **MIT, open source**. Treat all commits and code comments as public.

When committing, don't attribute Cursor, Claude, or any AI tool. Don't reference internal pricing, revenue, or private endpoints. Don't commit secrets. Auth tokens are read from `~/.summer/` at runtime, never hard-coded.

Expand All @@ -25,7 +25,7 @@ If you're an AI agent or developer with zero context: read [`AGENTS.md`](../AGEN
|---|---|---|
| Product | Summer | The system: library + tools + project memory (this repo). |
| npm package | `summer-engine` | What users install. Never recommend `summer-cli` (an unrelated, inactive package we do not own). |
| GitHub repo | `summerengine/summer` | Rename pending — today the repo is `SummerEngine/summer-engine-agent`; redirects will hold once renamed. |
| GitHub repo | `summerengine/summer` | Renamed from `summer-engine-agent` on 2026-09-10; GitHub redirects hold the old URL. Org display casing is still `SummerEngine`; GitHub URLs are case-insensitive. |
| Binary | `summer` | The CLI entry point. |
| Brand for the editor | Summer Engine | The closed desktop app (editor + runtime). |
| Copy rule | — | "Summer" for the system, "`summer-engine` npm package" for the package, "Summer Engine" for the editor. Full conventions: [`NAMING.md`](NAMING.md). |
Expand Down
2 changes: 1 addition & 1 deletion docs/NAMING.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ One story for what is called what. Three docs used to tell three different ones;
|---|---|---|
| **The product** | **Summer** | The open-source system in this repo: the library, the live tools (MCP + CLI), project memory, evals. "Install Summer", "build it with Summer", "Summer's library". |
| **The editor** | **Summer Engine** | The proprietary desktop app — editor + runtime — that `summer install` downloads. Always two words. Never shorten it to "Summer" when you mean the app; never call the system "Summer Engine". |
| **GitHub repo** | `summerengine/summer` | **Rename pending.** Today the repo is `SummerEngine/summer-engine-agent`; the rename to `summer` (and the org casing to `summerengine`) happens together with the 3.0.0 release, and GitHub redirects keep old links working. Write the new name in prose, with a parenthetical noting the rename until it lands. |
| **GitHub repo** | `summerengine/summer` | Renamed from `summer-engine-agent` with the 3.0.0 release (2026-09-10); GitHub redirects keep old links working. The org's display casing is still `SummerEngine` — URLs are case-insensitive, so `summerengine/summer` is the name to write. |
| **npm package** | `summer-engine` | What users install: `npx -y summer-engine@latest …`. Stays as-is forever — thousands of MCP configs run it. Never recommend `summer-cli` (an unrelated, inactive package we do not own). |
| **Binary** | `summer` | The CLI entry point (`package.json` `bin.summer`), also the MCP server (`summer mcp`). |

Expand Down
6 changes: 3 additions & 3 deletions docs/NPM_PUBLISH_QUICK_COMMANDS.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,13 @@

This is the approved manual release path until trusted publishing is configured in the public repository. Run it yourself in an interactive macOS Terminal. Do not run the final publish through an AI shell.

The version bump, changelog, and release contents must already be reviewed, committed, and merged to `SummerEngine/summer-engine-agent` `main`. This procedure intentionally makes no source changes.
The version bump, changelog, and release contents must already be reviewed, committed, and merged to `summerengine/summer` `main`. This procedure intentionally makes no source changes.

## 1. Clone the exact public source into a new directory

```bash
export RELEASE_DIR="$(mktemp -d)/summer-engine-agent"
git clone --branch main --single-branch https://github.com/SummerEngine/summer-engine-agent.git "$RELEASE_DIR"
export RELEASE_DIR="$(mktemp -d)/summer"
git clone --branch main --single-branch https://github.com/summerengine/summer.git "$RELEASE_DIR"
cd "$RELEASE_DIR"
git pull --ff-only origin main
```
Expand Down
2 changes: 1 addition & 1 deletion docs/OVERVIEW.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Summer Engine is the AI game engine. **Summer** — this repo — is the open-source layer that makes any coding agent fluent in it.

Source: [github.com/SummerEngine/summer-engine-agent](https://github.com/SummerEngine/summer-engine-agent)
Source: [github.com/summerengine/summer](https://github.com/summerengine/summer)

## What's in here

Expand Down
4 changes: 2 additions & 2 deletions docs/RELEASING.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Releasing `summer-engine`

The npm package is `summer-engine`, its binary is `summer`, and its public source is [SummerEngine/summer-engine-agent](https://github.com/SummerEngine/summer-engine-agent) — this repository. It is the only checkout that publishes; the engine monorepo carries a `private: true` mirror that must never be published from.
The npm package is `summer-engine`, its binary is `summer`, and its public source is [summerengine/summer](https://github.com/summerengine/summer) — this repository. It is the only checkout that publishes; the engine monorepo carries a `private: true` mirror that must never be published from.

For the exact copy-paste procedure, use [`NPM_PUBLISH_QUICK_COMMANDS.md`](./NPM_PUBLISH_QUICK_COMMANDS.md). It publishes only from a clean, fresh clone of public `main` and stops if the candidate version is not newer than npm `latest`. A major release soaks on the `next` dist-tag before `latest` moves — the 3.0.0 sequence is [`RELEASE-3.0.0.md`](./RELEASE-3.0.0.md).

Expand Down Expand Up @@ -44,7 +44,7 @@ No Apple or Windows application-signing certificate is involved in the npm packa

## Provenance and trusted publishing

Trusted publishing is not the current release path. Before enabling it, configure npm to trust an exact workflow in the public `SummerEngine/summer-engine-agent` repository and review the workflow separately.
Trusted publishing is not the current release path. Before enabling it, configure npm to trust an exact workflow in the public `summerengine/summer` repository and review the workflow separately.

Current npm requirements include:

Expand Down
2 changes: 1 addition & 1 deletion docs/SETUP_PROMPT.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Use this when a human wants to install Summer Engine from Claude Code, Cursor, Codex, Devin Desktop (formerly Windsurf), Cline, Roo Code, Gemini CLI, GitHub Copilot CLI, GitHub Copilot in VS Code, or OpenCode.

Source: https://github.com/SummerEngine/summer-engine-agent
Source: https://github.com/summerengine/summer
MCP setup page: https://summerengine.com/mcp

Paste this into the AI environment:
Expand Down
2 changes: 1 addition & 1 deletion docs/TESTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ session: `alias summer="node $PWD/dist/bin/summer.js"`.
writes on launch. Without it, every `[engine]` tool prints
"Summer Engine is not running (or no project is open)" and exits 1 — that is
the expected engine-less result, not a bug.
- A checkout: `git clone https://github.com/SummerEngine/summer-engine-agent && cd summer-engine-agent && git checkout <branch under test>`.
- A checkout: `git clone https://github.com/summerengine/summer && cd summer && git checkout <branch under test>`.

## b. Build

Expand Down
2 changes: 1 addition & 1 deletion docs/design/STATUS.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Single page. If it is not here, it is not real. Updated 2026-09-10. Companions:

## Where the code is

- Toolkit: this repository (`SummerEngine/summer-engine-agent`), npm package `summer-engine` 3.0.0, unpublished. npm `latest` is still 2.8.2. Release order and rollback: `docs/RELEASE-3.0.0.md`.
- Toolkit: this repository (`summerengine/summer`), npm package `summer-engine` 3.0.0, unpublished. npm `latest` is still 2.8.2. Release order and rollback: `docs/RELEASE-3.0.0.md`.
- Engine: Summer Engine 0.5.66 is the combined build the toolkit is verified against (125 ops); 0.5.65 is the shipped engine today.
- Web: the library-feedback endpoint (`POST /api/mcp/library-feedback`) is a 404 in production until its web PR merges; until then every report returns `dropped:true, reason: endpoint_missing`.

Expand Down
2 changes: 1 addition & 1 deletion integrations/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ How the plugin manifests reference skills, and what is verified:
| claude | `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json`, `.mcp.json` | MCP: `~/.claude.json` (user) / `.mcp.json` (project); skills: `~/.claude/skills/` (user) / `.claude/skills/` (project); slash commands from `commands/` to `~/.claude/commands/` |
| codex | `.codex-plugin/plugin.json` | MCP: `~/.codex/config.toml` (TOML); skills: `.agents/skills/` |
| cursor | `.cursor-plugin/plugin.json` | MCP: `~/.cursor/mcp.json` / `.cursor/mcp.json`; skills: `.cursor/rules/` |
| factory | `.factory-plugin/plugin.json` | nothing — there is no `summer setup factory` target. Install via the plugin marketplace: `droid plugin marketplace add https://github.com/SummerEngine/summer-engine-agent` then `droid plugin install summer@summer-engine`. Factory reads MCP from the plugin's `.mcp.json` and skills only from a root `skills/` dir (this package ships them under `library/skills/`, so the manifest `skills` array is not read by Factory — open gap) |
| factory | `.factory-plugin/plugin.json` | nothing — there is no `summer setup factory` target. Install via the plugin marketplace: `droid plugin marketplace add https://github.com/summerengine/summer` then `droid plugin install summer@summer-engine`. Factory reads MCP from the plugin's `.mcp.json` and skills only from a root `skills/` dir (this package ships them under `library/skills/`, so the manifest `skills` array is not read by Factory — open gap) |
| gemini | `gemini-extension.json` | extension dir `~/.gemini/extensions/summer-engine/`: the generated manifest (renamed `summer-engine` to match the dir, MCP launcher swapped to `npx -y summer-engine@latest mcp`) + `GEMINI.md` + `AGENTS.md`; skills: `~/.gemini/extensions/summer-engine/skills/<slug>/SKILL.md` (Gemini extension-skill discovery; user scope only) |
| windsurf (Devin Desktop) | — | MCP: `~/.codeium/windsurf/mcp_config.json`; rules: `.windsurfrules` |
| cline | — | MCP: VS Code global storage (`saoudrizwan.claude-dev`); rules: `.clinerules` |
Expand Down
2 changes: 1 addition & 1 deletion integrations/factory/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ There is no `summer setup factory` target (`summer setup` rejects `factory`).
Install through the plugin marketplace instead:

```
droid plugin marketplace add https://github.com/SummerEngine/summer-engine-agent
droid plugin marketplace add https://github.com/summerengine/summer
droid plugin install summer@summer-engine --scope user
```

Expand Down
1 change: 1 addition & 0 deletions node_modules
4 changes: 2 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
"summer-cli",
"summer-mcp",
"summer-agent",
"summer-engine-agent",
"summer",
"game-engine",
"ai-game-engine",
"godot",
Expand All @@ -25,7 +25,7 @@
"homepage": "https://summerengine.com",
"repository": {
"type": "git",
"url": "git+https://github.com/SummerEngine/summer-engine-agent.git"
"url": "git+https://github.com/summerengine/summer.git"
},
"publishConfig": {
"access": "public",
Expand Down
2 changes: 1 addition & 1 deletion registry/generated/plugin.claude.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
"url": "https://summerengine.com"
},
"homepage": "https://summerengine.com",
"repository": "https://github.com/SummerEngine/summer-engine-agent",
"repository": "https://github.com/summerengine/summer",
"license": "MIT",
"keywords": [
"game-dev",
Expand Down
2 changes: 1 addition & 1 deletion registry/generated/plugin.codex.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
"url": "https://summerengine.com"
},
"homepage": "https://summerengine.com",
"repository": "https://github.com/SummerEngine/summer-engine-agent",
"repository": "https://github.com/summerengine/summer",
"license": "MIT",
"keywords": [
"game-dev",
Expand Down
2 changes: 1 addition & 1 deletion registry/generated/plugin.cursor.json
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
},
"publisher": "summer-engine",
"homepage": "https://summerengine.com",
"repository": "https://github.com/SummerEngine/summer-engine-agent",
"repository": "https://github.com/summerengine/summer",
"license": "MIT",
"category": "developer-tools",
"keywords": [
Expand Down
2 changes: 1 addition & 1 deletion registry/generated/plugin.factory.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
"url": "https://summerengine.com"
},
"homepage": "https://summerengine.com",
"repository": "https://github.com/SummerEngine/summer-engine-agent",
"repository": "https://github.com/summerengine/summer",
"license": "MIT",
"keywords": [
"game-dev",
Expand Down
8 changes: 4 additions & 4 deletions scripts/generate-registry/manifests.ts
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ function buildClaudePlugin(i: ManifestInputs): string {
description: `Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a ${i.toolCount}-tool MCP bridge to the local desktop app.`,
author: author(),
homepage: "https://summerengine.com",
repository: "https://github.com/SummerEngine/summer-engine-agent",
repository: "https://github.com/summerengine/summer",
license: "MIT",
keywords: [
"game-dev",
Expand Down Expand Up @@ -133,7 +133,7 @@ function buildCodexPlugin(i: ManifestInputs): string {
description: `Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a ${i.toolCount}-tool MCP bridge. Build games by talking.`,
author: author(),
homepage: "https://summerengine.com",
repository: "https://github.com/SummerEngine/summer-engine-agent",
repository: "https://github.com/summerengine/summer",
license: "MIT",
keywords: [
"game-dev",
Expand Down Expand Up @@ -183,7 +183,7 @@ function buildCursorPlugin(i: ManifestInputs): string {
},
publisher: "summer-engine",
homepage: "https://summerengine.com",
repository: "https://github.com/SummerEngine/summer-engine-agent",
repository: "https://github.com/summerengine/summer",
license: "MIT",
category: "developer-tools",
keywords: [
Expand Down Expand Up @@ -213,7 +213,7 @@ function buildFactoryPlugin(i: ManifestInputs): string {
version: i.version,
author: author(),
homepage: "https://summerengine.com",
repository: "https://github.com/SummerEngine/summer-engine-agent",
repository: "https://github.com/summerengine/summer",
license: "MIT",
keywords: ["game-dev", "godot", "ai-game-engine", "skills", "mcp"],
skills: skillPaths(i.skillSlugs),
Expand Down
2 changes: 1 addition & 1 deletion src/cli/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -90,6 +90,6 @@ function printIntro(version: string): void {
console.log(` ${c.brand("/play")} ${c.dim("Run the game and report state")}`);
console.log("");
console.log(` ${c.dim("Docs:")} https://summerengine.com/docs`);
console.log(` ${c.dim("Source:")} https://github.com/SummerEngine/summer-engine-agent`);
console.log(` ${c.dim("Source:")} https://github.com/summerengine/summer`);
console.log("");
}
Loading