cmpose

Generate Compose Multiplatform projects on your own machine — from any AI agent, through MCP.

Ask your agent for an app ("a blank Compose Multiplatform app called Habits with Room and theming") and get a buildable Android + iOS project from a tested template: Koin, Navigation, Ktor, Room, DataStore, theming, multi-language, RevenueCat purchases, AdMob ads, detekt, backend (Ktor server, Firebase sign-in, sharing; blank only; turns on multi-language and networking) and CI as options. What each option adds: packages/mcp/README.md.

It also generates Unity mobile games ("a 2D Unity game called SkyHopper with ads and leaderboards"): a Unity 6 (URP) Android + iOS project from the pinned game template (whinstudio/cmpose-game-template), as a showcase sample game (2D runner or 3D track) or a blank game with flags for saving, theming, multi-language, networking, RevenueCat purchases, AdMob ads and Play Games / Game Center leaderboards, up to 3 feature modules and your real IDs.

• @cmpose/core — the generator library (the same code cmpose.dev runs).
• @cmpose/mcp — a local stdio MCP server with four tools: cmp_describe, cmp_generate, game_describe and game_generate.

Requires Node.js 20+ and git. The first generation downloads the pinned template (whinstudio/cmpose-template) into ~/.cache/cmpose (override: CMPOSE_CACHE_DIR).

Use with Claude Code

claude mcp add cmpose -- npx -y @cmpose/mcp

Use with other MCP clients

Add the server to the client's mcpServers configuration:

{
  "mcpServers": {
    "cmpose": {
      "command": "npx",
      "args": ["-y", "@cmpose/mcp"]
    }
  }
}

cmp_generate takes projectName, appName, packageName and an absolute outputDir (required), plus optional templateType (showcase | blank), features, featuresConfig (blank only), minSdk, iosVersion, ci and templateRef; cmp_describe lists the defaults and rules. game_generate takes the same required fields plus optional companyName, templateType, render (2d | 3d), flags and features (blank only), minSdk, iosVersion, ids and templateRef; game_describe lists the flags, ID groups and limits.

Develop

npm install
npm test
npm run scan    # public hygiene scan: private paths, names, addresses, secrets

The 5 real-template tests in packages/core/test/fileService.importSort.test.js run only when CMP_REAL_TEMPLATE_DIR points to a checkout of the template, e.g. CMP_REAL_TEMPLATE_DIR=/path/to/template-checkout npm test; otherwise they are skipped.