⁄⁄ moonshift cli

Moonshift in your terminal.

One prompt, a deployed app, from a single self-contained binary. No Node, Bun, or build step to install.

What it is

The CLI is a thin client over the Moonshift API. You type an idea, it builds and deploys a real site, and you can iterate on it without leaving the command line. All of the building, deploying, and marketing happens server-side, nothing heavy runs on your machine.

It ships as one self-contained binary. There is no runtime to install first: no Node, no Bun, no build step.

Install

macOS and Linux:

bash
curl -fsSL https://moonshift.io/install.sh | bash

Windows (PowerShell):

powershell
irm https://moonshift.io/install.ps1 | iex

The installer detects your OS and architecture, downloads the matching binary, verifies its SHA-256, and installs it to a bin directory on your PATH. To upgrade later, run the same command again, or moonshift update.

First run

Sign in once. The login uses a device-code flow: it prints a short code and a URL, and you approve it in your browser.

bash
moonshift login

Then run moonshift on its own to open the interactive launchpad, an idea box with a slash palette. Inside a pipe or a CI job, where there is no interactive terminal, it prints a static list of commands instead.

Commands

Every command runs as moonshift <command>.

moonshift

Open the interactive launchpad: an idea box with a slash palette.

moonshift login

Sign in once via a device-code flow (prints a code + URL to approve in your browser).

moonshift create "your idea"

Build and deploy a real site from one prompt. Add --fast / --standard / --full.

moonshift connect

See what's linked and open web settings. moonshift connect github links your repo.

moonshift resume

Re-open a past run and keep iterating on it.

moonshift stats <id>

Show the metrics for a run: time, cost in moons, agents, and deploy URL.

moonshift doctor

Run an auth + API health checklist.

moonshift update

Upgrade to the latest CLI version.

There are three build modes: fast (the default), standard, and full. Pass them as flags, e.g. moonshift create "a landing page for my bakery" --standard.

Connect your accounts

Run moonshift connect to see what is linked and open the web settings page. Run moonshift connect github to link GitHub and wait until it is done.

bash
moonshift connect
moonshift connect github

Once GitHub is connected, builds push to your own repository and every iteration commits back to it.

Iterate after launch

After a run ships, type a change in the composer, for example make the buttons green, and press Enter. A new version iterates on the existing project and redeploys to the same URL.

step 01
Ship the first version

Run create with your idea. You get a live URL when it finishes.

step 02
Describe one change

Type a plain-language edit in the composer and press Enter.

step 03
Redeploy to the same URL

Moonshift iterates on the project and ships the new version in place.

step 04
Re-open anytime

Run moonshift resume to pick up a past run later.

Security and source

The CLI is a thin client. It does three things: it calls the Moonshift API, it draws the terminal UI, and it reads and writes your local config. That is all it contains.

The pipeline, prompts, and orchestration stay server-side and are never shipped to your machine. The binary is the minified compiled bundle: no TypeScript source, no source maps, and no embedded secrets. It authenticates with the per-user token created by moonshift login.

Troubleshooting

  • Command not found.Add the printed bin directory to your PATH, then open a new terminal.
  • “Not signed in”.Run moonshift login and approve the code in your browser.
  • Garbled icons.Run with MOONSHIFT_ICONS=ascii for plain characters.
  • Check health.Run moonshift doctor for an auth and API checklist.

Install it, type one idea, get a live URL.

One binary, no runtime to set up. Sign in once and build from the command line.

0 to 100 playbook