---
title: Deploy with the CLI
url: "/learn/getting-started/cli/"
canonical_url: https://docs.blossom88.com/learn/getting-started/cli/
markdown_url: https://docs.blossom88.com/learn/getting-started/cli.md
summary: Take your project live on Blossom Cloud with a coding agent.
categories:
- cli
- learn
---

# Deploy with the CLI

Go from the project you're building to a live HTTPS URL with your coding agent.

## Install and log in

Open your project in a coding agent such as Codex or Claude Code. In the
terminal on the machine where your agent runs, install Blossom and sign in.

    curl -fsSL https://cli.blossom88.com/install.sh | sh
    blossom login

Choose your Account and a **Blossom Cloud** Location in the browser, then
install the skill.

    blossom skill:install

Start a fresh agent conversation in the same project to load the skill.

## With a coding agent


> **Ask your AI agent:** Deploy this project on Blossom. Show me the plan and wait for my approval.



Check the Git repository, Account, Location, and what will run. For your
Organization's first Blossom Cloud deployment,
[activate Cloud](/docs/billing/).
When you're ready, tell your agent **Deploy it**.

## Watch it go live

Your agent follows the deployment and gives you the **App URL**.

![Terminal output from the Blossom CLI: the web container is receiving traffic, the deployment completed, and the App's HTTPS URL.](/assets/images/getting-started/cli/deployment-complete.webp)


Open the URL to use your App. In Blossom, open **Activity** in its Environment
to see the deployment steps and logs.

![The deployed FastAPI example open in a browser at its onblsm.com URL, displaying the greeting Hello, Blossom!](/assets/images/getting-started/cli/live-app.webp)


## Run the commands yourself

The [CLI Walkthrough](/learn/cli-walkthrough/) shows the commands
your agent runs and how to configure each resource yourself.

## What You Get

Your project is live at a shareable HTTPS URL. When you make a change, ask
your agent to deploy it to the same Environment.
