Skip to content

Repository files navigation

Playfrog

Publishing resources for Playfrog, a publishing platform for browser games made with coding agents. No account is needed for the first publish.

Tell your coding agent:

Publish this game to Playfrog.

Playfrog returns a public play page, a link for claiming the game, and a credential the agent can use for later updates. Publishing and updates are free.

This repository holds the publishing resources: an agent skill, a runnable example, and links to the canonical documentation. It is not the source of the playfrog npm package.

What can be published

Static browser content with an index.html at the top level: HTML, JavaScript, CSS, images, audio and other browser assets. If a framework produces a dist or build folder, publish that folder rather than the source directory.

No application server, database or private backend secret is required, and none is supported.

Method Size limit
CLI and browser upload 50 MB
Connector (MCP) uploads 2.5 MB

Publishing methods

Four supported paths. An agent should use whichever its environment allows.

CLI

npx playfrog ./game

Optional metadata:

npx playfrog ./game --title "Pond Pong" --genre arcade --desc "Two-player paddle game."

MCP

Playfrog runs a remote MCP server at https://mcp-open.playfrog.games/mcp (streamable HTTP, no auth). For Claude Code:

claude mcp add --transport http playfrog https://mcp-open.playfrog.games/mcp

Useful when the agent cannot run shell commands.

HTTP

POST https://api.playfrog.games/v1/games as multipart/form-data. See the OpenAPI document.

Browser upload

playfrog.gg/publish for someone without a terminal.

After publishing

Share the returned play URL. Open the claim URL within seven days to keep the game online permanently and add it to the public gallery. An unclaimed game expires after seven days.

Keep the returned manage credential private. It updates the same game without changing its public URL.

Contents

Try it

git clone https://github.com/playfrog-gg/playfrog-publish
npx playfrog ./playfrog-publish/examples/minimal-game

That publishes a real game and prints its links. It is unclaimed, so it expires in seven days unless you open the claim URL.

Documentation

The canonical documentation lives on the site. This repository links to it rather than copying it, so it cannot drift.

Support

Questions and problems: support@playfrog.gg. We aim to reply within five working days.

Issues are disabled on this repository for now; email is the reliable path. Security reports go through SECURITY.md.

License

MIT. The example game and the skill are original work and free to reuse.

About

Publishing resources for Playfrog: agent skill, runnable example, and links to the docs. Not the npm package source.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors