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:
initadddocsmcp
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.