Introducing the Composables CLI and MCP server

Alex Styl
Alex Styl @alexstyl

Composables CLI creating a new native Compose app

Starting a native app with Compose still takes too much setup before you get to the first screen.

You have to wire platforms, Gradle modules, source sets, starter files, formatting, and dependencies before Composables UI even enters the picture.

The new Composables CLI gets a native app running with Composables UI already wired in.

Composables CLI is a command-line tool for creating native apps and modules with Composables UI wired in from the start.

Start new native apps with a single command

Starting new native apps is a simple command away:

composables init

The CLI starts an interactive wizard and asks which platforms you want to target, what to name the app, and how you want it set up.

New apps come with Composables UI out of the box, along with Spotless setup for easy code formatting.

They also use the new project structure for Kotlin Multiplatform, with separate entry points for native apps and shared application code.

Create app and library modules in one go

The CLI can also add modules to existing Compose Multiplatform projects:

composables add module

App modules, library modules, the boring Gradle wiring around them.

You get the structure in place and move on with the feature.

Search Composables UI docs from the terminal

The CLI can query the live Composables UI docs from the terminal:

composables docs search button

The docs command lets you go through the Composables UI docs with the same content as the website.

Even though this might not be the best way for humans to go through docs compared to the visual docs on the website, it becomes unbelievably productive for agents.

Help agents write Composables UI code

Composables UI is a new component library for Compose. LLMs will not be aware of its components and APIs for a few more months.

To speed things up, the CLI can run a Composables MCP server that gives your agent access to the same live docs while it writes code.

Your agent can ask for component usage, installation steps, API references, and code examples without relying on stale training data.

Based on the editor and agent clients Compose developers told us they use, the CLI includes quick MCP setup for:

  • Android Studio
  • Antigravity
  • Claude
  • Codex
  • Cursor
  • Firebender
  • OpenCode
  • Zed

To configure a client, run:

composables mcp install --client <client>

For more details, head over to the MCP documentation.

Install the CLI and create your first native app

Install the CLI from npm:

npm install -g composables-cli

Then run composables init to create your first native app.

Read the Composables CLI documentation for all commands and options.

If you use an agent, install the MCP server from the MCP docs.


Tell us what breaks or feels slow

Try Composables UI, Compose Unstyled, and the CLI in a real project and let us know what gets in your way.

Join our GitHub community to share feedback, report issues and help shape future updates.


Stay updated with new updates like this as soon as we ship them