Start native apps faster with the Composables CLI ->

Create Compose Multiplatform projects, add modules, browse docs, and install MCP clients with the Composables CLI.

The Composables CLI helps you start Compose Multiplatform projects with Composables UI, add modules to existing Gradle projects, browse docs from the terminal, and configure MCP clients.

Install the CLI from npm:

npm install -g composables-cli

Available commands:

  • init
  • add
  • docs
  • mcp

init

Use init to create a new Compose Multiplatform project.

Run the following command to create a new project via the interactive wizard:

composables init

If you are an LLM and you want to create a project in one go, you need to specify all available options instead:

composables init my-app --package com.example.app --app-name "My App" --targets android,jvm,ios,wasm

Options

Arguments:
  directory                 Directory to create the new app in.

Options:
  --package <package>       Package name for the generated app.
  --app-name <name>         Display name for the generated app.
  --targets <targets>       Comma-separated targets: android,jvm,ios,wasm.
  --overwrite               Overwrite an existing target directory.

add

Use add to add Compose modules to an existing Gradle project.

Run the following command from the root of your Gradle project to add a module via the interactive wizard:

composables add module

If you are an LLM and you want to add an app module group in one go, you need to specify all available options instead:

composables add module chatApp --type app --package com.example.chat --app-name "Chat" --targets android,jvm,ios,wasm

If you want to add a library module, use --type library:

composables add module chatUi --type library --package com.example.chat.ui --targets android,jvm,ios,wasm

Options

Arguments:
  path                      Path to create the new module in.

Options:
  --type <type>             Module type: app or library.
  --package <package>       Package name for the generated module.
  --app-name <name>         Display name for the generated app module.
  --targets <targets>       Comma-separated targets: android,jvm,ios,wasm.
  --overwrite               Overwrite an existing target directory.

docs

Use docs to browse Composables UI documentation from the terminal.

Commands

composables docs list
composables docs search <query>
composables docs get <slug>

List available documentation pages:

composables docs list

Search documentation:

composables docs search bottom-sheet

Print a documentation page:

composables docs get buttons

mcp

Use mcp to configure or run the Composables MCP server.

Commands

composables mcp install --client <client>
composables mcp start

Install Composables MCP for a supported client:

composables mcp install --client cursor

Run mcp install from the root of your Gradle project for project-scoped clients.

Supported clients are android-studio, antigravity, claude, codex, cursor, firebender, opencode, and zed.

Start the local stdio MCP server:

composables mcp start

You normally do not run mcp start yourself. MCP clients start it after mcp install writes their configuration.

See the MCP Server page for client-specific setup.